@henjicc/ai-sdk 0.8.0 → 0.10.0

package/docs/model-adaptation/Nano-Banana-Pro/Nano-Banana-Pro_KIE.md

@@ -1,64 +1,64 @@
-# Nano Banana Pro · KIE
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-22 |
-| 模态 | 图片 |
-| 供应商 | KIE.ai（聚合平台） |
-| 平台模型 ID | `nano-banana-pro` |
-| 接口形态 | **异步任务**（`createTask` + `recordInfo`） |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-
-> KIE 的文档标题是「Nano Banana Pro 图生图」，路径在 `market/google/pro-image-to-image`，但 `image_input` 是**可选**的——同一个 model 同时承载文生图与图生图。
-
-## 1. 接入协议
-
-- **Base URL**：`https://api.kie.ai`
-- **鉴权**：`Authorization: Bearer <API_KEY>`
-- **提交**：`POST /api/v1/jobs/createTask`，体为 `{ model: "nano-banana-pro", callBackUrl?, input }`
-- **查询**：`GET /api/v1/jobs/recordInfo?taskId=...`
-- **结果**：`JSON.parse(resultJson)` → `{ resultUrls: [...] }`
-
-## 2. 请求参数
-
-| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
-|---|---|---|---|---|
-| `input.prompt` | string | 必填 | — | 最多 **10000** 字符（Nano Banana 2 是 20000） |
-| `input.image_input` | array | 可选 | — | 输入图。**最多 8 张**（比 APIMart / Fal 的 14 张少）。字段名是 `image_input`。传上传后的文件 URL；支持 `image/jpeg`、`image/png`、`image/webp`；单张 ≤ 30 MB |
-| `input.aspect_ratio` | string | 可选 | **`1:1`** | `1:1`、`2:3`、`3:2`、`3:4`、`4:3`、`4:5`、`5:4`、`9:16`、`16:9`、`21:9`、`auto`（11 个，无极端比例） |
-| `input.resolution` | string | 可选 | `1K` | `1K` / `2K` / `4K` |
-| `input.output_format` | string | 可选 | `png` | `png` / `jpg`（注意是 `jpg` 不是 `jpeg`） |
-
-## 3. 响应结构
-
-`state=success` 后 `JSON.parse(resultJson)` → `{ "resultUrls": ["https://..."] }`。
-
-## 4. 价格
-
-来源：[KIE 定价页](https://kie.ai/pricing)（2026-08-22 读取，搜索 `nano banana pro`；1 Credit = $0.005）。
-
-| 规格 | 积分 | 我们的价格 | 官方 / Fal 参考价 | 节省 |
-|---|---|---|---|---|
-| 1/2K | 18.0 /张 | **$0.09/张** | $0.15 | 40% |
-| 4K | 24.0 /张 | **$0.12/张** | $0.3 | 60% |
-
-## 5. 适配要点
-
-- 本项目默认**绝对不显示**：`seed`、负面提示词。KIE 本接口两个字段都没有。
-- `output_format` 默认不显示、不请求；取值是 `jpg` 不是 `jpeg`。
-- **参考图上限只有 8 张**，是所有 Nano Banana Pro 供应商里最少的；跨供应商的上传上限要按供应商取值。
-- 图片字段名是 `image_input`（不是 `image_urls`）。
-- `aspect_ratio` 默认 `1:1`，而 APIMart / Fal 的编辑端点默认 `auto`。
-- 提示词上限 10000 字符。
-- `resultJson` 是 JSON 字符串，必须二次 parse。
-
-## 6. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| Nano Banana Pro（图生图页，同时承载文生图） | https://docs.kie.ai/cn/market/google/pro-image-to-image | 否 |
-| 获取任务详情 | https://docs.kie.ai/cn/market/common/get-task-detail | 否 |
-| 通用 API 快速入门 | https://docs.kie.ai/cn/common-api/quickstart | 否 |
-| 定价页（搜 `nano banana pro`） | https://kie.ai/pricing | 否 |
-| API Key 管理 | https://kie.ai/api-key | **是** |
+# Nano Banana Pro · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-22 |
+| 模态 | 图片 |
+| 供应商 | KIE.ai（聚合平台） |
+| 平台模型 ID | `nano-banana-pro` |
+| 接口形态 | **异步任务**（`createTask` + `recordInfo`） |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+> KIE 的文档标题是「Nano Banana Pro 图生图」，路径在 `market/google/pro-image-to-image`，但 `image_input` 是**可选**的——同一个 model 同时承载文生图与图生图。
+
+## 1. 接入协议
+
+- **Base URL**：`https://api.kie.ai`
+- **鉴权**：`Authorization: Bearer <API_KEY>`
+- **提交**：`POST /api/v1/jobs/createTask`，体为 `{ model: "nano-banana-pro", callBackUrl?, input }`
+- **查询**：`GET /api/v1/jobs/recordInfo?taskId=...`
+- **结果**：`JSON.parse(resultJson)` → `{ resultUrls: [...] }`
+
+## 2. 请求参数
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `input.prompt` | string | 必填 | — | 最多 **10000** 字符（Nano Banana 2 是 20000） |
+| `input.image_input` | array | 可选 | — | 输入图。**最多 8 张**（比 APIMart / Fal 的 14 张少）。字段名是 `image_input`。传上传后的文件 URL；支持 `image/jpeg`、`image/png`、`image/webp`；单张 ≤ 30 MB |
+| `input.aspect_ratio` | string | 可选 | **`1:1`** | `1:1`、`2:3`、`3:2`、`3:4`、`4:3`、`4:5`、`5:4`、`9:16`、`16:9`、`21:9`、`auto`（11 个，无极端比例） |
+| `input.resolution` | string | 可选 | `1K` | `1K` / `2K` / `4K` |
+| `input.output_format` | string | 可选 | `png` | `png` / `jpg`（注意是 `jpg` 不是 `jpeg`） |
+
+## 3. 响应结构
+
+`state=success` 后 `JSON.parse(resultJson)` → `{ "resultUrls": ["https://..."] }`。
+
+## 4. 价格
+
+来源：[KIE 定价页](https://kie.ai/pricing)（2026-08-22 读取，搜索 `nano banana pro`；1 Credit = $0.005）。
+
+| 规格 | 积分 | 我们的价格 | 官方 / Fal 参考价 | 节省 |
+|---|---|---|---|---|
+| 1/2K | 18.0 /张 | **$0.09/张** | $0.15 | 40% |
+| 4K | 24.0 /张 | **$0.12/张** | $0.3 | 60% |
+
+## 5. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。KIE 本接口两个字段都没有。
+- `output_format` 默认不显示、不请求；取值是 `jpg` 不是 `jpeg`。
+- **参考图上限只有 8 张**，是所有 Nano Banana Pro 供应商里最少的；跨供应商的上传上限要按供应商取值。
+- 图片字段名是 `image_input`（不是 `image_urls`）。
+- `aspect_ratio` 默认 `1:1`，而 APIMart / Fal 的编辑端点默认 `auto`。
+- 提示词上限 10000 字符。
+- `resultJson` 是 JSON 字符串，必须二次 parse。
+
+## 6. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Nano Banana Pro（图生图页，同时承载文生图） | https://docs.kie.ai/cn/market/google/pro-image-to-image | 否 |
+| 获取任务详情 | https://docs.kie.ai/cn/market/common/get-task-detail | 否 |
+| 通用 API 快速入门 | https://docs.kie.ai/cn/common-api/quickstart | 否 |
+| 定价页（搜 `nano banana pro`） | https://kie.ai/pricing | 否 |
+| API Key 管理 | https://kie.ai/api-key | **是** |

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-Audio-3.1-TTS-Plus/Qwen-Audio-3.1-TTS-Plus_/347/231/276/347/202/274.md

@@ -0,0 +1,59 @@
+# Qwen Audio 3.1 TTS Plus · 百炼
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-11-07 |
+| 模态 | 音频（语音合成） |
+| 供应商 | 阿里云百炼（官方） |
+| 项目模型 ID | `bailian-qwen-audio-3.1-tts-plus`（通用标识 `qwen-audio-3.1-tts-plus`） |
+| 平台模型 ID | `qwen-audio-3.1-tts-plus` |
+| 接口形态 | 同步 HTTP（非流式） |
+| 文档 / 价格可见性 | 公开，无需登录 |
+
+## 1. 接入协议
+
+- `POST /api/v1/services/audio/tts/SpeechSynthesizer`，与 Qwen Audio 3.1 TTS Flash 同一端点与请求结构；项目沿用 `https://dashscope.aliyuncs.com`，北京地域 API Key
+- 成功：`output.finish_reason: "stop"`，`output.audio.url` 为完整音频，24 小时有效；`usage` 返回 `input_tokens` / `output_tokens` / `characters`
+
+## 2. 请求参数（项目使用部分）
+
+| 字段 | 取值 | 项目处理 |
+|---|---|---|
+| `model` | `qwen-audio-3.1-tts-plus` | 固定 |
+| `input.text` | 待合成文本，支持 SSML / LaTeX | 提示词全文 |
+| `input.voice` | 本模型支持的系统音色或复刻 / 设计音色；**音色不能跨模型混用**，不匹配报 `InvalidParameter` | 4 个旗舰系统音色，默认 `longanlingxin_v3.1`；允许填自定义 ID |
+| `input.format` | `mp3`（默认）/ `pcm` / `wav` / `opus` | 固定 mp3 |
+| `input.rate` | 0.5–2.0，默认 1.0 | 「语速」 |
+| `input.instruction` | 方言、情感、角色指令 | 「演绎指令」，空时不发 |
+| `sample_rate`、`volume`、`pitch`、`seed`、`language_hints`、`hot_fix`、`enable_ssml`、AIGC 标识 | 可选 | 不显示、不发送 |
+
+系统音色（[音色列表](https://help.aliyun.com/zh/model-studio/qwen-audio-tts-voice-list)「qwen-audio-3.1-tts-plus 旗舰音色」）：
+
+| voice | 名称 | 性别 |
+|---|---|---|
+| `longanlingxin_v3.1` | 龙安灵心_v3.1 | 女 |
+| `xunanchuan_v3.1` | 许南川 | 男 |
+| `longanhuan_v3.1` | 龙安欢_v3.1 | 女 |
+| `longanfengyue_v3.1` | 龙安风悦_v3.1 | 女 |
+
+四个音色均支持 SSML、指令控制、时间戳。
+
+## 3. 价格
+
+来源：[模型价格](https://help.aliyun.com/zh/model-studio/model-pricing)「Qwen-Audio-TTS」（2026-11-07 读取，无需登录），华北2（北京）：**¥1.4 / 万字符**，只按输入文本计费，输出不计费；北京地域有 1 万字符免费额度（90 天）。新加坡 ¥2.19 / 万字符，项目不用。
+
+字符规则：汉字（含繁体、日文汉字、韩文汉字）记 2 个字符，其余字符（字母、数字、标点、空格、假名、韩文字母）记 1 个；SSML 标签不计。官方示例“中A文123”为 8 个字符。项目按此规则估价（未扣除 SSML 标签，略偏高）。
+
+## 4. 项目适配
+
+- **单独建模型，不并入 Flash 的版本选项**：Plus 只支持 4 个旗舰音色，Flash 有 68 个，音色不能跨模型混用；音色选择器按模型配置，并成版本会让用户在 Plus 下选到不可用音色。两者计费方式也不同（Plus 按字符，Flash 按 token）。
+- 复刻音色列表（`remoteModelId`）未对 Plus 开放：现有列表接口按 `qwen-audio-3.1-tts-flash-` 前缀筛选，Plus 复刻音色的前缀与可用性官方页面未说明；用户可直接填写已有音色 ID。
+- 请求构建与价格测试：`packages/ai-sdk/tests/catalog/official-videos.test.ts`「百炼 Qwen Audio 3.1 TTS Plus」。同步结果解析沿用 `providers/bailian.ts` 的 `/SpeechSynthesizer` 分支（已有 TTS 测试覆盖）。未做真实付费调用。
+
+## 5. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Qwen-Audio-TTS HTTP API | https://help.aliyun.com/zh/model-studio/qwen-audio-tts-http-api | 否 |
+| Qwen-Audio-TTS 音色列表 | https://help.aliyun.com/zh/model-studio/qwen-audio-tts-voice-list | 否 |
+| 模型价格 | https://help.aliyun.com/zh/model-studio/model-pricing | 否 |

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 | **是** |