@henjicc/ai-sdk 0.2.8 → 0.4.0

package/docs/model-adaptation/Pixelcut-/350/203/214/346/231/257/347/247/273/351/231/244/Pixelcut-/350/203/214/346/231/257/347/247/273/351/231/244_Fal.md

@@ -1,79 +1,79 @@
-# Pixelcut 背景移除（Fal）适配资料
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-29 |
-| 平台 | Fal |
-| 展示名 | Pixelcut Background Remover |
-| API endpoint ID | `pixelcut/background-removal` |
-| 模态 | JPEG/PNG 单图 → 透明背景 PNG |
-| SDK 入口 | `@henjicc/ai-sdk/tool-models/fal/pixelcut-background-removal` |
-| 工具包 | `@henjicc/ai-sdk/tool-packs/fal-image-utility-tools` |
-| 价格 | `$0.016 / image` |
-| 登录状态 | 模型页、`llms.txt` 与 OpenAPI 公开；真实调用需要 Fal Key |
-
-## 1. 能力与输出模式
-
-Pixelcut 端点支持三种 `output_format`：
-
-- `rgba`：完整 RGBA 结果，返回 `image.url`。
-- `alpha`：单独 alpha 结果，返回 `image.url`。
-- `zip`：返回 `file.url`。
-
-项目对新模型不显示、不发送 `output_format`，因此该工具使用官方默认 `rgba`，产品契约只接收透明背景图的 `image.url`。`alpha` 和 `zip` 不进入首版。
-
-## 2. 接口与队列契约
-
-- 鉴权：`Authorization: Key <FAL_KEY>`
-- 直连：`POST https://fal.run/pixelcut/background-removal`
-- 队列提交：`POST https://queue.fal.run/pixelcut/background-removal`
-- 状态：`GET https://queue.fal.run/pixelcut/background-removal/requests/{request_id}/status`
-- 结果：`GET https://queue.fal.run/pixelcut/background-removal/requests/{request_id}`
-- 取消：`PUT https://queue.fal.run/pixelcut/background-removal/requests/{request_id}/cancel`
-- 首版结果路径：`image.url`
-
-队列状态仅有 `IN_QUEUE` / `IN_PROGRESS` / `COMPLETED`，`status` / `request_id` 必填。结果 schema 的 `image` 和 `file` 都是可选且可空，所以 `COMPLETED` 后必须取结果并对当前 RGBA 契约严格校验非空 `image.url`；空对象不能当作成功。其余复用 [Fal 供应商队列契约](../供应商/Fal.md#2-队列契约)。
-
-## 3. 请求字段
-
-| 字段 | 类型 | 必填 | 默认 / 范围 | 产品策略 |
-|---|---|---|---|---|
-| `image_url` | string | 是 | 只明确支持 JPEG / PNG；官方未公布尺寸和文件大小上限 | 恰好 1 张已有素材，经 Fal CDN 上传；提交前校验 MIME/extension |
-| `output_format` | enum | 否 | `rgba`；`rgba` / `alpha` / `zip` | 不展示、不发送，使用默认 `rgba` |
-| `sync_mode` | boolean | 否 | `true` | **不展示但固定发送 `false`** |
-
-`sync_mode` 是本批工具中必须覆盖官方默认的例外：官方说明 `true` 会返回 data URL，而 Henji-AI 的持久队列和媒体落盘需要 CDN URL。请求 builder 必须固定发送 `sync_mode: false`，不能只依赖平台默认。
-
-## 4. 请求与响应示例
-
-```json
-{
-  "image_url": "https://v3.fal.media/files/.../product.jpg",
-  "sync_mode": false
-}
-```
-
-```json
-{
-  "image": {
-    "url": "https://cdn3.pixelcut.app/fal/background-remover/result.png"
-  }
-}
-```
-
-## 5. 计价与未知项
-
-- 实时 `llms.txt` 标价 `$0.016 / image`，静态估价为 `$0.016 / 次`。
-- 输入文档只写 JPEG / PNG，未说明是否完整保留 EXIF/色彩配置，也未给大小、尺寸、最大主体数、延迟 SLA 和 CDN 保留期。
-- 付费验收要覆盖头发/半透明物体、珠宝反射、多主体、白色商品和输入 PNG 透明通道。
-- 结果 URL 使用 Pixelcut CDN 而不一定是 `fal.media`，结果解析不能按域名过滤。
-
-## 6. 原始链接索引
-
-| 内容 | 链接 | 是否需登录 | 核查日期 |
-|---|---|---|---|
-| 模型页与当前价格 | https://fal.ai/models/pixelcut/background-removal | 否 | 2026-08-29 |
-| 实时字段、枚举、示例与价格 | https://fal.ai/models/pixelcut/background-removal/llms.txt | 否 | 2026-08-29 |
-| OpenAPI（输出可空性、必填与枚举） | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=pixelcut/background-removal | 否 | 2026-08-29 |
-| Fal 队列协议 | https://fal.ai/docs/documentation/model-apis/inference/queue | 否 | 2026-08-29 |
-| Fal 价格 API | https://fal.ai/docs/platform-apis/v1/models/pricing | 否（调用需 Key） | 2026-08-29 |
+# Pixelcut 背景移除（Fal）适配资料
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-29 |
+| 平台 | Fal |
+| 展示名 | Pixelcut Background Remover |
+| API endpoint ID | `pixelcut/background-removal` |
+| 模态 | JPEG/PNG 单图 → 透明背景 PNG |
+| SDK 入口 | `@henjicc/ai-sdk/tool-models/fal/pixelcut-background-removal` |
+| 工具包 | `@henjicc/ai-sdk/tool-packs/fal-image-utility-tools` |
+| 价格 | `$0.016 / image` |
+| 登录状态 | 模型页、`llms.txt` 与 OpenAPI 公开；真实调用需要 Fal Key |
+
+## 1. 能力与输出模式
+
+Pixelcut 端点支持三种 `output_format`：
+
+- `rgba`：完整 RGBA 结果，返回 `image.url`。
+- `alpha`：单独 alpha 结果，返回 `image.url`。
+- `zip`：返回 `file.url`。
+
+项目对新模型不显示、不发送 `output_format`，因此该工具使用官方默认 `rgba`，产品契约只接收透明背景图的 `image.url`。`alpha` 和 `zip` 不进入首版。
+
+## 2. 接口与队列契约
+
+- 鉴权：`Authorization: Key <FAL_KEY>`
+- 直连：`POST https://fal.run/pixelcut/background-removal`
+- 队列提交：`POST https://queue.fal.run/pixelcut/background-removal`
+- 状态：`GET https://queue.fal.run/pixelcut/background-removal/requests/{request_id}/status`
+- 结果：`GET https://queue.fal.run/pixelcut/background-removal/requests/{request_id}`
+- 取消：`PUT https://queue.fal.run/pixelcut/background-removal/requests/{request_id}/cancel`
+- 首版结果路径：`image.url`
+
+队列状态仅有 `IN_QUEUE` / `IN_PROGRESS` / `COMPLETED`，`status` / `request_id` 必填。结果 schema 的 `image` 和 `file` 都是可选且可空，所以 `COMPLETED` 后必须取结果并对当前 RGBA 契约严格校验非空 `image.url`；空对象不能当作成功。其余复用 [Fal 供应商队列契约](../供应商/Fal.md#2-队列契约)。
+
+## 3. 请求字段
+
+| 字段 | 类型 | 必填 | 默认 / 范围 | 产品策略 |
+|---|---|---|---|---|
+| `image_url` | string | 是 | 只明确支持 JPEG / PNG；官方未公布尺寸和文件大小上限 | 恰好 1 张已有素材，经 Fal CDN 上传；提交前校验 MIME/extension |
+| `output_format` | enum | 否 | `rgba`；`rgba` / `alpha` / `zip` | 不展示、不发送，使用默认 `rgba` |
+| `sync_mode` | boolean | 否 | `true` | **不展示但固定发送 `false`** |
+
+`sync_mode` 是本批工具中必须覆盖官方默认的例外：官方说明 `true` 会返回 data URL，而 Henji-AI 的持久队列和媒体落盘需要 CDN URL。请求 builder 必须固定发送 `sync_mode: false`，不能只依赖平台默认。
+
+## 4. 请求与响应示例
+
+```json
+{
+  "image_url": "https://v3.fal.media/files/.../product.jpg",
+  "sync_mode": false
+}
+```
+
+```json
+{
+  "image": {
+    "url": "https://cdn3.pixelcut.app/fal/background-remover/result.png"
+  }
+}
+```
+
+## 5. 计价与未知项
+
+- 实时 `llms.txt` 标价 `$0.016 / image`，静态估价为 `$0.016 / 次`。
+- 输入文档只写 JPEG / PNG，未说明是否完整保留 EXIF/色彩配置，也未给大小、尺寸、最大主体数、延迟 SLA 和 CDN 保留期。
+- 付费验收要覆盖头发/半透明物体、珠宝反射、多主体、白色商品和输入 PNG 透明通道。
+- 结果 URL 使用 Pixelcut CDN 而不一定是 `fal.media`，结果解析不能按域名过滤。
+
+## 6. 原始链接索引
+
+| 内容 | 链接 | 是否需登录 | 核查日期 |
+|---|---|---|---|
+| 模型页与当前价格 | https://fal.ai/models/pixelcut/background-removal | 否 | 2026-08-29 |
+| 实时字段、枚举、示例与价格 | https://fal.ai/models/pixelcut/background-removal/llms.txt | 否 | 2026-08-29 |
+| OpenAPI（输出可空性、必填与枚举） | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=pixelcut/background-removal | 否 | 2026-08-29 |
+| Fal 队列协议 | https://fal.ai/docs/documentation/model-apis/inference/queue | 否 | 2026-08-29 |
+| Fal 价格 API | https://fal.ai/docs/platform-apis/v1/models/pricing | 否（调用需 Key） | 2026-08-29 |

package/docs/model-adaptation/Qwen-Image-3.0/Qwen-Image-3.0_APIMart.md

@@ -1,117 +1,117 @@
-# Qwen Image 3.0 · APIMart
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-22 |
-| 模态 | 图片 |
-| 供应商 | APIMart（聚合平台） |
-| 平台模型 ID | `qwen-image-3.0`（标准）、`qwen-image-3.0-pro`（Pro） |
-| 接口形态 | **异步任务** |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-
-## 1. 接入协议
-
-- **Base URL**：`https://api.apimart.ai`
-- **鉴权**：`Authorization: Bearer <API_KEY>`
-- **提交**：`POST /v1/images/generations` → `{ "code": 200, "data": [{ "status": "submitted", "task_id": "..." }] }`
-- **查询**：`GET /v1/tasks/{task_id}`，读 `result.images`
-- **轮询建议**：每 **3–5 秒**一次，超时约 **3 分钟**（2K + 多张更慢）
-- **结果存储**：图片已镜像到平台 CDN，文档称**返回地址长期可用**
-
-## 2. 支持的模型
-
-| 模型名 | 说明 | 最大张数 | 分辨率 |
-|---|---|---|---|
-| `qwen-image-3.0` | 指令理解清晰，文字渲染稳定，常规出图更划算 | 6 张 | 1K / 2K |
-| `qwen-image-3.0-pro` | 内容更丰实，适合报纸、分镜、菜单、试卷等密集排版 | 6 张 | 1K / 2K |
-
-> 排版密集、字多的场景优先用 `-pro`。**模型名与 2.0 系列不兼容互换。**
-
-## 3. 能力清单
-
-| 能力 | 触发方式 |
-|---|---|
-| 文生图 | 只传 `prompt` |
-| 图生图 / 图像编辑（1–3 张参考图） | `image_urls` |
-| 提示词智能改写 | `prompt_extend: true` + `prompt_extend_mode` |
-| 多张输出 | `n`（1–6） |
-| 反向提示词 | `negative_prompt` |
-
-## 4. 请求参数（Body）
-
-| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
-|---|---|---|---|---|
-| `model` | string | 必填 | — | `qwen-image-3.0` / `qwen-image-3.0-pro` |
-| `prompt` | string | 必填 | — | 最长约 **4.5k token** |
-| `image_urls` | string[] | 可选 | — | **1–3 张**。公网 `http(s)://` URL 或 `data:image/png;base64,...`（base64 会先转存）。格式 JPG/JPEG/PNG/BMP/TIFF/WEBP/GIF；单张 ≤ 10 MB；宽高建议 384–2048 px |
-| `resolution` | string | 可选 | `1K` | `1K`（兼容小写）/ `2K`。也可跳过档位在 `size` 中直接写像素；**直接给像素时，面积 > 225 万像素按 2K 档计费** |
-| `size` | string | 可选 | `1:1` | 比例 `1:1`、`4:3`、`3:4`、`16:9`、`9:16`、`3:2`、`2:3`；兼容 `16x9` 写法；或直接像素 `1024x1024`。自定义像素时**宽与高各自**须在 512–2048，宽高比 1:8 ~ 8:1。**不传 `size` 也不传 `resolution` 时固定出 1024×1024** |
-| `n` | integer | 可选 | `1` | **1–6，超过 6 自动截断为 6** |
-| `negative_prompt` | string | 可选 | — | 反向提示词。**本项目规则：绝对不显示**，不下发 |
-| `prompt_extend` | boolean | 可选 | **`false`** | 提示词智能改写。APIMart **默认关闭**（官方百炼默认是开启），以保证结果可预测 |
-| `prompt_extend_mode` | string | 可选 | — | 仅 3.0 系列，且需 `prompt_extend: true`。`direct`（T2I/I2I 都可）/ `agent`（**仅文生图**，改写更激进）。取值非法时忽略该字段 |
-| `nsfw_check` | boolean | 可选 | `false` | `true` 时用 `omni-moderation-latest` 预审提示词与输入图 |
-
-### 尺寸对照表（`resolution` 档位 × `size` 比例）
-
-| 分辨率 | 1:1 | 4:3 | 3:4 | 16:9 | 9:16 | 3:2 | 2:3 |
-|---|---|---|---|---|---|---|---|
-| 1K | 1024×1024 | 1152×864 | 864×1152 | 1280×720 | 720×1280 | 1248×832 | 832×1248 |
-| 2K | 2048×2048 | 2048×1536 | 1536×2048 | 2048×1152 | 1152×2048 | 2048×1360 | 1360×2048 |
-
-> APIMart 的比例集合**没有 `21:9`**（KIE 有），也没有 `2:1` / `1:2`。
-
-## 5. 限制汇总（文档明列）
-
-| 项 | 限制 |
-|---|---|
-| 提示词 | ≤ 4.5k token |
-| 输出尺寸 | 自定义像素时宽、高各自 512–2048；宽高比 1:8 ~ 8:1 |
-| 出图张数 | 1–6（超出自动截断） |
-| 参考图数量 | 1–3 张 |
-| 参考图格式 | JPG / JPEG / PNG / BMP / TIFF / WEBP / GIF |
-| 参考图大小 | ≤ 10 MB，宽高建议 384–2048 px |
-
-常见 400 错误：自定义 `size` 宽或高不在 512–2048、比例越界、`agent` 用在图生图、参考图不可访问或超 10 MB。限流返回 429。
-
-## 6. 响应结构
-
-提交返回 `{ code, data: [{ status: "submitted", task_id }] }`；轮询 `GET /v1/tasks/{task_id}` 读 `result.images`（`url` 为数组，多张时一个任务含多个结果）。
-
-## 7. 价格
-
-来源：[APIMart 定价中心](https://apimart.ai/zh/pricing)（2026-08-22 读取，1 Credit ≈ $0.1）。
-
-**QWEN-IMAGE-3.0**（3 个档位，默认/1K/2K 同价）
-
-| 规格 | 我们的价格 | 官方价 | 节省 |
-|---|---|---|---|
-| 默认 / 1K / 2K | 0.205712 Credits/张 ≈ **$0.0205712/张** | $0.025714/张 | 20% |
-
-**QWEN-IMAGE-3.0-PRO**
-
-| 规格 | 我们的价格 | 官方价 | 节省 |
-|---|---|---|---|
-| 默认 / 1K | 0.285712 Credits/张 ≈ **$0.0285712/张** | $0.035714/张 | 20% |
-| 2K | 0.571432 Credits/张 ≈ **$0.0571432/张** | $0.071429/张 | 20% |
-
-计费规则（文档）：按实际出图张数 × 分辨率档位计费；档位按**实际像素面积**判定（> 225 万像素为 2K）。`qwen-image-3.0` 的 1K/2K 同价；`-pro` 的 2K 为 1K 的两倍。**任务失败全额退款；参考图不额外收费。**
-
-## 8. 适配要点
-
-- 本项目默认**绝对不显示**：`seed`、负面提示词。APIMart 本接口**有 `negative_prompt`**，必须主动不注册、不下发（无 `seed` 字段）。
-- `prompt_extend` 在 APIMart 默认 `false`，与百炼官方默认 `true` 相反；跨供应商同一模型的默认行为不一致，需在 schema 层显式指定。
-- 比例集合仅 7 个（无 `21:9`），与 KIE 的 8 个不一致；`n > 6` 会**静默截断**而非报错。
-- 不传 `size` 与 `resolution` 时固定 1024×1024，不是「模型自动推荐」——与百炼官方行为不同。
-- `output_format` 该接口未提供，无需处理。
-
-## 9. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| Qwen Image 3.0 图像生成 API | https://docs.apimart.ai/cn/api-reference/images/qwen-image-3.0/generation | 否 |
-| 同页纯 Markdown | https://docs.apimart.ai/cn/api-reference/images/qwen-image-3.0/generation.md | 否 |
-| 获取任务状态 | https://docs.apimart.ai/cn/api-reference/tasks/status | 否 |
-| 定价中心（搜 QWEN-IMAGE-3.0 / QWEN-IMAGE-3.0-PRO） | https://apimart.ai/zh/pricing | 否 |
-| API Key 管理 | https://apimart.ai/keys | **是** |
+# Qwen Image 3.0 · APIMart
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-22 |
+| 模态 | 图片 |
+| 供应商 | APIMart（聚合平台） |
+| 平台模型 ID | `qwen-image-3.0`（标准）、`qwen-image-3.0-pro`（Pro） |
+| 接口形态 | **异步任务** |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+## 1. 接入协议
+
+- **Base URL**：`https://api.apimart.ai`
+- **鉴权**：`Authorization: Bearer <API_KEY>`
+- **提交**：`POST /v1/images/generations` → `{ "code": 200, "data": [{ "status": "submitted", "task_id": "..." }] }`
+- **查询**：`GET /v1/tasks/{task_id}`，读 `result.images`
+- **轮询建议**：每 **3–5 秒**一次，超时约 **3 分钟**（2K + 多张更慢）
+- **结果存储**：图片已镜像到平台 CDN，文档称**返回地址长期可用**
+
+## 2. 支持的模型
+
+| 模型名 | 说明 | 最大张数 | 分辨率 |
+|---|---|---|---|
+| `qwen-image-3.0` | 指令理解清晰，文字渲染稳定，常规出图更划算 | 6 张 | 1K / 2K |
+| `qwen-image-3.0-pro` | 内容更丰实，适合报纸、分镜、菜单、试卷等密集排版 | 6 张 | 1K / 2K |
+
+> 排版密集、字多的场景优先用 `-pro`。**模型名与 2.0 系列不兼容互换。**
+
+## 3. 能力清单
+
+| 能力 | 触发方式 |
+|---|---|
+| 文生图 | 只传 `prompt` |
+| 图生图 / 图像编辑（1–3 张参考图） | `image_urls` |
+| 提示词智能改写 | `prompt_extend: true` + `prompt_extend_mode` |
+| 多张输出 | `n`（1–6） |
+| 反向提示词 | `negative_prompt` |
+
+## 4. 请求参数（Body）
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `model` | string | 必填 | — | `qwen-image-3.0` / `qwen-image-3.0-pro` |
+| `prompt` | string | 必填 | — | 最长约 **4.5k token** |
+| `image_urls` | string[] | 可选 | — | **1–3 张**。公网 `http(s)://` URL 或 `data:image/png;base64,...`（base64 会先转存）。格式 JPG/JPEG/PNG/BMP/TIFF/WEBP/GIF；单张 ≤ 10 MB；宽高建议 384–2048 px |
+| `resolution` | string | 可选 | `1K` | `1K`（兼容小写）/ `2K`。也可跳过档位在 `size` 中直接写像素；**直接给像素时，面积 > 225 万像素按 2K 档计费** |
+| `size` | string | 可选 | `1:1` | 比例 `1:1`、`4:3`、`3:4`、`16:9`、`9:16`、`3:2`、`2:3`；兼容 `16x9` 写法；或直接像素 `1024x1024`。自定义像素时**宽与高各自**须在 512–2048，宽高比 1:8 ~ 8:1。**不传 `size` 也不传 `resolution` 时固定出 1024×1024** |
+| `n` | integer | 可选 | `1` | **1–6，超过 6 自动截断为 6** |
+| `negative_prompt` | string | 可选 | — | 反向提示词。**本项目规则：绝对不显示**，不下发 |
+| `prompt_extend` | boolean | 可选 | **`false`** | 提示词智能改写。APIMart **默认关闭**（官方百炼默认是开启），以保证结果可预测 |
+| `prompt_extend_mode` | string | 可选 | — | 仅 3.0 系列，且需 `prompt_extend: true`。`direct`（T2I/I2I 都可）/ `agent`（**仅文生图**，改写更激进）。取值非法时忽略该字段 |
+| `nsfw_check` | boolean | 可选 | `false` | `true` 时用 `omni-moderation-latest` 预审提示词与输入图 |
+
+### 尺寸对照表（`resolution` 档位 × `size` 比例）
+
+| 分辨率 | 1:1 | 4:3 | 3:4 | 16:9 | 9:16 | 3:2 | 2:3 |
+|---|---|---|---|---|---|---|---|
+| 1K | 1024×1024 | 1152×864 | 864×1152 | 1280×720 | 720×1280 | 1248×832 | 832×1248 |
+| 2K | 2048×2048 | 2048×1536 | 1536×2048 | 2048×1152 | 1152×2048 | 2048×1360 | 1360×2048 |
+
+> APIMart 的比例集合**没有 `21:9`**（KIE 有），也没有 `2:1` / `1:2`。
+
+## 5. 限制汇总（文档明列）
+
+| 项 | 限制 |
+|---|---|
+| 提示词 | ≤ 4.5k token |
+| 输出尺寸 | 自定义像素时宽、高各自 512–2048；宽高比 1:8 ~ 8:1 |
+| 出图张数 | 1–6（超出自动截断） |
+| 参考图数量 | 1–3 张 |
+| 参考图格式 | JPG / JPEG / PNG / BMP / TIFF / WEBP / GIF |
+| 参考图大小 | ≤ 10 MB，宽高建议 384–2048 px |
+
+常见 400 错误：自定义 `size` 宽或高不在 512–2048、比例越界、`agent` 用在图生图、参考图不可访问或超 10 MB。限流返回 429。
+
+## 6. 响应结构
+
+提交返回 `{ code, data: [{ status: "submitted", task_id }] }`；轮询 `GET /v1/tasks/{task_id}` 读 `result.images`（`url` 为数组，多张时一个任务含多个结果）。
+
+## 7. 价格
+
+来源：[APIMart 定价中心](https://apimart.ai/zh/pricing)（2026-08-22 读取，1 Credit ≈ $0.1）。
+
+**QWEN-IMAGE-3.0**（3 个档位，默认/1K/2K 同价）
+
+| 规格 | 我们的价格 | 官方价 | 节省 |
+|---|---|---|---|
+| 默认 / 1K / 2K | 0.205712 Credits/张 ≈ **$0.0205712/张** | $0.025714/张 | 20% |
+
+**QWEN-IMAGE-3.0-PRO**
+
+| 规格 | 我们的价格 | 官方价 | 节省 |
+|---|---|---|---|
+| 默认 / 1K | 0.285712 Credits/张 ≈ **$0.0285712/张** | $0.035714/张 | 20% |
+| 2K | 0.571432 Credits/张 ≈ **$0.0571432/张** | $0.071429/张 | 20% |
+
+计费规则（文档）：按实际出图张数 × 分辨率档位计费；档位按**实际像素面积**判定（> 225 万像素为 2K）。`qwen-image-3.0` 的 1K/2K 同价；`-pro` 的 2K 为 1K 的两倍。**任务失败全额退款；参考图不额外收费。**
+
+## 8. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。APIMart 本接口**有 `negative_prompt`**，必须主动不注册、不下发（无 `seed` 字段）。
+- `prompt_extend` 在 APIMart 默认 `false`，与百炼官方默认 `true` 相反；跨供应商同一模型的默认行为不一致，需在 schema 层显式指定。
+- 比例集合仅 7 个（无 `21:9`），与 KIE 的 8 个不一致；`n > 6` 会**静默截断**而非报错。
+- 不传 `size` 与 `resolution` 时固定 1024×1024，不是「模型自动推荐」——与百炼官方行为不同。
+- `output_format` 该接口未提供，无需处理。
+
+## 9. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Qwen Image 3.0 图像生成 API | https://docs.apimart.ai/cn/api-reference/images/qwen-image-3.0/generation | 否 |
+| 同页纯 Markdown | https://docs.apimart.ai/cn/api-reference/images/qwen-image-3.0/generation.md | 否 |
+| 获取任务状态 | https://docs.apimart.ai/cn/api-reference/tasks/status | 否 |
+| 定价中心（搜 QWEN-IMAGE-3.0 / QWEN-IMAGE-3.0-PRO） | https://apimart.ai/zh/pricing | 否 |
+| API Key 管理 | https://apimart.ai/keys | **是** |

package/docs/model-adaptation/Qwen-Image-3.0/Qwen-Image-3.0_Fal.md

@@ -1,84 +1,84 @@
-# Qwen Image 3.0 · Fal
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-28 |
-| 模态 | 图片 |
-| 供应商 | fal.ai（聚合平台） |
-| 平台模型 ID | `alibaba/qwen-image-3/text-to-image`、`alibaba/qwen-image-3/edit` |
-| 接口形态 | 队列异步（推荐）或同步直连 |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-
-> Fal 上只有一个 Qwen Image 3 系列端点，未区分标准版 / Pro 版。价格档位（1K $0.04、2K $0.075）与百炼 Pro 的档位结构一致，但 Fal 未标注具体对应哪个上游 model id。
-
-## 1. 接入协议（Fal 通用）
-
-- **鉴权**：`Authorization: Key $FAL_KEY`
-- **同步**：`POST https://fal.run/<endpoint-id>`
-- **队列**：`POST https://queue.fal.run/<endpoint-id>` → `{ request_id, status_url, response_url, cancel_url }`；`GET .../requests/{id}/status`（`IN_QUEUE` / `IN_PROGRESS` / `COMPLETED`）；`GET .../requests/{id}` 取结果
-- **权威 schema**：`https://fal.ai/models/<endpoint-id>/llms.txt`
-
-## 2. 能力清单
-
-| 能力 | endpoint id |
-|---|---|
-| 文生图 | `alibaba/qwen-image-3/text-to-image` |
-| 图像编辑（1–3 张参考图） | `alibaba/qwen-image-3/edit` |
-
-## 3. 请求参数（两个端点共有）
-
-| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
-|---|---|---|---|---|
-| `prompt` | string | 必填 | — | 支持中英文，最长 5000 字符 |
-| `negative_prompt` | string | 可选 | `""` | 最长 500 字符。**本项目规则：绝对不显示**，不下发 |
-| `image_size` | 枚举或对象 | 可选 | 文生图 `square_hd`；编辑**无默认**（不传时模型自动决定） | 枚举 `square_hd`、`square`、`portrait_4_3`、`portrait_16_9`、`landscape_4_3`、`landscape_16_9` 等，或 `{ width, height }`。总像素须在 512×512 ~ 2048×2048 |
-| `enable_prompt_expansion` | boolean | 可选 | **`true`** | LLM 自动改写提示词 |
-| `seed` | integer | 可选 | 随机 | `[0, 2147483647]`。**本项目规则：绝对不显示**，不下发 |
-| `enable_safety_checker` | boolean | 可选 | `true` | 关闭需账号授权 |
-| `sync_mode` | boolean | 可选 | `false` | `true` 时以 data URI 返回且不入请求历史 |
-| `num_images` | integer | 可选 | `1` | 1–6 |
-| `output_format` | string | 可选 | `png` | `jpeg` / `png` / **`webp`**（比其他供应商多一个 webp） |
-
-**仅 `edit` 有：**
-
-| 字段 | 类型 | 必填 | 说明 |
-|---|---|---|---|
-| `image_urls` | string[] | 必填 | **1–3 张，必填**。顺序有意义——在 prompt 中以 'image 1' / 'image 2' / 'image 3' 引用。每边 384–2048 px；单张 ≤ 10 MB；格式 JPEG、JPG、**PNG（不能带 alpha）**、WEBP |
-
-## 4. 响应结构
-
-```json
-{ "images": [ { "url": "https://v3b.fal.media/files/b/.../xxx.png" } ], "seed": 42 }
-```
-
-`images` 与 `seed` 都是必返回字段。输出里的 `seed` 只是回传，不暴露成可编辑参数。
-
-## 5. 价格
-
-来源：两个端点的 `llms.txt`（2026-08-22 读取），两端点同价。
-
-| 输出分辨率 | 单价 |
-|---|---|
-| 1K | **$0.04 / 张** |
-| 2K | **$0.075 / 张** |
-
-## 6. 适配要点
-
-- 本项目默认**绝对不显示**：`seed`、负面提示词。Fal 本端点**两个字段都存在**，必须主动不注册、不下发。
-- `output_format`、`sync_mode` 不展示、不请求。
-- `edit` 的 `image_urls` 是**必填**（不像 Seedream 的 edit 可省），且 PNG 不允许带 alpha 通道——透明图需先合成背景。
-- `edit` 的 `image_size` 没有默认值，不传就由模型决定，与文生图行为不同。
-- `enable_prompt_expansion` 默认 `true`，会改变出图结果。
-- SDK 固定比例覆盖通用 10 档并提供显式 `1MP` 请求档；`1MP` 文生图发送约 1024²、16 对齐的对象，编辑分支按官方契约省略 `image_size`。旧默认仍是 1K + 提示词扩写开启；需要复刻插件旧结果时 adapter 必须显式传 `falQwenImage30Resolution: '1MP'` 与 `falQwenImage30PromptExpansion: false`。
-
-## 7. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| 文生图模型页 | https://fal.ai/models/alibaba/qwen-image-3/text-to-image | 否 |
-| 文生图 schema + 价格 | https://fal.ai/models/alibaba/qwen-image-3/text-to-image/llms.txt | 否 |
-| 编辑模型页 | https://fal.ai/models/alibaba/qwen-image-3/edit | 否 |
-| 编辑 schema + 价格 | https://fal.ai/models/alibaba/qwen-image-3/edit/llms.txt | 否 |
-| 队列协议 | https://fal.ai/docs/documentation/model-apis/inference/queue | 否 |
-| API Key 创建 | https://fal.ai/dashboard/keys | **是** |
+# Qwen Image 3.0 · Fal
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-28 |
+| 模态 | 图片 |
+| 供应商 | fal.ai（聚合平台） |
+| 平台模型 ID | `alibaba/qwen-image-3/text-to-image`、`alibaba/qwen-image-3/edit` |
+| 接口形态 | 队列异步（推荐）或同步直连 |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+> Fal 上只有一个 Qwen Image 3 系列端点，未区分标准版 / Pro 版。价格档位（1K $0.04、2K $0.075）与百炼 Pro 的档位结构一致，但 Fal 未标注具体对应哪个上游 model id。
+
+## 1. 接入协议（Fal 通用）
+
+- **鉴权**：`Authorization: Key $FAL_KEY`
+- **同步**：`POST https://fal.run/<endpoint-id>`
+- **队列**：`POST https://queue.fal.run/<endpoint-id>` → `{ request_id, status_url, response_url, cancel_url }`；`GET .../requests/{id}/status`（`IN_QUEUE` / `IN_PROGRESS` / `COMPLETED`）；`GET .../requests/{id}` 取结果
+- **权威 schema**：`https://fal.ai/models/<endpoint-id>/llms.txt`
+
+## 2. 能力清单
+
+| 能力 | endpoint id |
+|---|---|
+| 文生图 | `alibaba/qwen-image-3/text-to-image` |
+| 图像编辑（1–3 张参考图） | `alibaba/qwen-image-3/edit` |
+
+## 3. 请求参数（两个端点共有）
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `prompt` | string | 必填 | — | 支持中英文，最长 5000 字符 |
+| `negative_prompt` | string | 可选 | `""` | 最长 500 字符。**本项目规则：绝对不显示**，不下发 |
+| `image_size` | 枚举或对象 | 可选 | 文生图 `square_hd`；编辑**无默认**（不传时模型自动决定） | 枚举 `square_hd`、`square`、`portrait_4_3`、`portrait_16_9`、`landscape_4_3`、`landscape_16_9` 等，或 `{ width, height }`。总像素须在 512×512 ~ 2048×2048 |
+| `enable_prompt_expansion` | boolean | 可选 | **`true`** | LLM 自动改写提示词 |
+| `seed` | integer | 可选 | 随机 | `[0, 2147483647]`。**本项目规则：绝对不显示**，不下发 |
+| `enable_safety_checker` | boolean | 可选 | `true` | 关闭需账号授权 |
+| `sync_mode` | boolean | 可选 | `false` | `true` 时以 data URI 返回且不入请求历史 |
+| `num_images` | integer | 可选 | `1` | 1–6 |
+| `output_format` | string | 可选 | `png` | `jpeg` / `png` / **`webp`**（比其他供应商多一个 webp） |
+
+**仅 `edit` 有：**
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `image_urls` | string[] | 必填 | **1–3 张，必填**。顺序有意义——在 prompt 中以 'image 1' / 'image 2' / 'image 3' 引用。每边 384–2048 px；单张 ≤ 10 MB；格式 JPEG、JPG、**PNG（不能带 alpha）**、WEBP |
+
+## 4. 响应结构
+
+```json
+{ "images": [ { "url": "https://v3b.fal.media/files/b/.../xxx.png" } ], "seed": 42 }
+```
+
+`images` 与 `seed` 都是必返回字段。输出里的 `seed` 只是回传，不暴露成可编辑参数。
+
+## 5. 价格
+
+来源：两个端点的 `llms.txt`（2026-08-22 读取），两端点同价。
+
+| 输出分辨率 | 单价 |
+|---|---|
+| 1K | **$0.04 / 张** |
+| 2K | **$0.075 / 张** |
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。Fal 本端点**两个字段都存在**，必须主动不注册、不下发。
+- `output_format`、`sync_mode` 不展示、不请求。
+- `edit` 的 `image_urls` 是**必填**（不像 Seedream 的 edit 可省），且 PNG 不允许带 alpha 通道——透明图需先合成背景。
+- `edit` 的 `image_size` 没有默认值，不传就由模型决定，与文生图行为不同。
+- `enable_prompt_expansion` 默认 `true`，会改变出图结果。
+- SDK 固定比例覆盖通用 10 档并提供显式 `1MP` 请求档；`1MP` 文生图发送约 1024²、16 对齐的对象，编辑分支按官方契约省略 `image_size`。旧默认仍是 1K + 提示词扩写开启；需要复刻插件旧结果时 adapter 必须显式传 `falQwenImage30Resolution: '1MP'` 与 `falQwenImage30PromptExpansion: false`。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 文生图模型页 | https://fal.ai/models/alibaba/qwen-image-3/text-to-image | 否 |
+| 文生图 schema + 价格 | https://fal.ai/models/alibaba/qwen-image-3/text-to-image/llms.txt | 否 |
+| 编辑模型页 | https://fal.ai/models/alibaba/qwen-image-3/edit | 否 |
+| 编辑 schema + 价格 | https://fal.ai/models/alibaba/qwen-image-3/edit/llms.txt | 否 |
+| 队列协议 | https://fal.ai/docs/documentation/model-apis/inference/queue | 否 |
+| API Key 创建 | https://fal.ai/dashboard/keys | **是** |