@henjicc/ai-sdk 0.2.8 → 0.4.0

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

@@ -1,103 +1,103 @@
-# Qwen Image 3.0 · KIE
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-22 |
-| 模态 | 图片 |
-| 供应商 | KIE.ai（聚合平台） |
-| 平台模型 ID | 标准版 `qwen3/text-to-image`、`qwen3/image-to-image`；Pro 版 `qwen3-pro/text-to-image`、`qwen3/pro-image-to-image` |
-| 接口形态 | **异步任务**（`createTask` + `recordInfo`） |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-
-> ⚠️ **文档不一致，接入前必须实测确认**：Pro 文生图页面的 `model` 字段中，`enum` 写的是 `qwen3-pro/text-to-image`，而 `default` 与描述文字写的是 `qwen3/pro-text-to-image`；Pro 图生图页面则统一为 `qwen3/pro-image-to-image`。
-
-## 1. 接入协议
-
-- **Base URL**：`https://api.kie.ai`
-- **鉴权**：`Authorization: Bearer <API_KEY>`
-- **提交**：`POST /api/v1/jobs/createTask`，体为 `{ model, callBackUrl?, input }`
-- **查询**：`GET /api/v1/jobs/recordInfo?taskId=...`
-- **终态**：`state` ∈ `waiting` / `queuing` / `generating` / `success` / `fail`
-- **结果**：`JSON.parse(resultJson)` → `{ resultUrls: [...] }`；失败读 `failCode` / `failMsg`
-
-## 2. 能力清单
-
-| 能力 | model |
-|---|---|
-| 标准版 文生图 | `qwen3/text-to-image` |
-| 标准版 图生图 | `qwen3/image-to-image` |
-| Pro 版 文生图 | `qwen3-pro/text-to-image`（见上方不一致提示） |
-| Pro 版 图生图 | `qwen3/pro-image-to-image` |
-
-> KIE 上 Qwen Image 3.0 **没有多张输出参数**（无 `n` / `num_images`），一次任务出 1 张。
-
-## 3. 请求参数（四个端点共有）
-
-| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
-|---|---|---|---|---|
-| `input.prompt` | string | 必填 | — | 0–5000 字符，支持中英文 |
-| `input.resolution` | string | 可选 | `1K` | `1K` / `2K` |
-| `input.image_size` | string | 可选 | **`16:9`** | `1:1`、`3:2`、`2:3`、`4:3`、`3:4`、`16:9`、`9:16`、`21:9`。注意**默认不是 1:1** |
-| `input.output_format` | string | 可选 | `png` | `png` / `jpeg` |
-| `input.prompt_extend` | boolean | 可选 | **`true`**（推荐） | 智能提示词改写 |
-| `input.nsfw_checker` | boolean | 可选 | `false` | `false` 时关闭内容过滤，结果直接返回 |
-| `input.negative_prompt` | string | 可选 | — | 0–5000 字符。**本项目规则：绝对不显示**，不下发 |
-| `input.seed` | integer | 可选 | `1` | `[0, 2147483647]`。**本项目规则：绝对不显示**，不下发 |
-
-**图生图端点额外必填：**
-
-| 字段 | 类型 | 必填 | 说明 |
-|---|---|---|---|
-| `input.image_urls` | array | 必填 | **1–3 张**。传上传后的文件 URL。支持 `image/jpeg`、`image/png`、`image/webp`、`image/bmp`、`image/tiff`、`image/gif`；每张 ≤ 10 MB |
-
-> KIE 没有 `prompt_extend_mode`（百炼与 APIMart 有 `direct` / `agent`）。
-
-## 4. 响应结构
-
-`state=success` 后 `JSON.parse(resultJson)` → `{ "resultUrls": ["https://..."] }`。
-
-## 5. 价格
-
-来源：[KIE 定价页](https://kie.ai/pricing)（2026-08-22 读取，搜索 `qwen image 3`；1 Credit = $0.005）。
-
-**Qwen image 3.0**
-
-| 规格 | 积分 | 我们的价格 | 官方 / Fal 参考价 |
-|---|---|---|---|
-| 文生图 1K | 4.8 /张 | **$0.024/张** | $0.03 |
-| 文生图 2K | 4.8 /张 | **$0.024/张** | $0.03 |
-| 输出 1K / 2K | 4.8 /张 | **$0.024/张** | $0.03 |
-| 输入图 1K / 2K | 0.5 /张 | **$0.0025/张** | $0.003 |
-
-**Qwen image 3.0 Pro**
-
-| 规格 | 积分 | 我们的价格 | 官方 / Fal 参考价 |
-|---|---|---|---|
-| 文生图 1K | 6.4 /张 | **$0.032/张** | $0.04 |
-| 文生图 2K | 12 /张 | **$0.06/张** | $0.075 |
-| 输出 1K | 6.4 /张 | **$0.032/张** | $0.04 |
-| 输出 2K | 12 /张 | **$0.06/张** | $0.075 |
-| 输入图 1K / 2K | 0.5 /张 | **$0.0025/张** | $0.003 |
-
-## 6. 适配要点
-
-- 本项目默认**绝对不显示**：`seed`、负面提示词。KIE 本接口**两个字段都存在**，必须主动不注册、不下发。
-- `image_size` 默认 `16:9`，与其他供应商的 `1:1` 默认不同；若产品语义是「默认方形」，必须显式下发 `1:1`。
-- 比例集合含 `21:9`（APIMart 没有）。
-- `prompt_extend` 默认 `true`，与 APIMart（`false`）相反。
-- Pro 端点的 model 字符串在官方文档中自相矛盾，接入时先用两种写法各打一次任务确认。
-- `resultJson` 是 JSON 字符串，必须二次 parse。
-
-## 7. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| Qwen3 文生图 | https://docs.kie.ai/cn/market/qwen3/text-to-image | 否 |
-| Qwen3 图生图 | https://docs.kie.ai/cn/market/qwen3/image-to-image | 否 |
-| Qwen3 Pro 文生图 | https://docs.kie.ai/cn/market/qwen3-pro/text-to-image | 否 |
-| Qwen3 Pro 图生图 | https://docs.kie.ai/cn/market/qwen3-pro/image-to-image | 否 |
-| 获取任务详情 | https://docs.kie.ai/cn/market/common/get-task-detail | 否 |
-| 通用 API 快速入门 | https://docs.kie.ai/cn/common-api/quickstart | 否 |
-| 定价页（搜 `qwen image 3`） | https://kie.ai/pricing | 否 |
-| API Key 管理 | https://kie.ai/api-key | **是** |
+# Qwen Image 3.0 · KIE
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-22 |
+| 模态 | 图片 |
+| 供应商 | KIE.ai（聚合平台） |
+| 平台模型 ID | 标准版 `qwen3/text-to-image`、`qwen3/image-to-image`；Pro 版 `qwen3-pro/text-to-image`、`qwen3/pro-image-to-image` |
+| 接口形态 | **异步任务**（`createTask` + `recordInfo`） |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+> ⚠️ **文档不一致，接入前必须实测确认**：Pro 文生图页面的 `model` 字段中，`enum` 写的是 `qwen3-pro/text-to-image`，而 `default` 与描述文字写的是 `qwen3/pro-text-to-image`；Pro 图生图页面则统一为 `qwen3/pro-image-to-image`。
+
+## 1. 接入协议
+
+- **Base URL**：`https://api.kie.ai`
+- **鉴权**：`Authorization: Bearer <API_KEY>`
+- **提交**：`POST /api/v1/jobs/createTask`，体为 `{ model, callBackUrl?, input }`
+- **查询**：`GET /api/v1/jobs/recordInfo?taskId=...`
+- **终态**：`state` ∈ `waiting` / `queuing` / `generating` / `success` / `fail`
+- **结果**：`JSON.parse(resultJson)` → `{ resultUrls: [...] }`；失败读 `failCode` / `failMsg`
+
+## 2. 能力清单
+
+| 能力 | model |
+|---|---|
+| 标准版 文生图 | `qwen3/text-to-image` |
+| 标准版 图生图 | `qwen3/image-to-image` |
+| Pro 版 文生图 | `qwen3-pro/text-to-image`（见上方不一致提示） |
+| Pro 版 图生图 | `qwen3/pro-image-to-image` |
+
+> KIE 上 Qwen Image 3.0 **没有多张输出参数**（无 `n` / `num_images`），一次任务出 1 张。
+
+## 3. 请求参数（四个端点共有）
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `input.prompt` | string | 必填 | — | 0–5000 字符，支持中英文 |
+| `input.resolution` | string | 可选 | `1K` | `1K` / `2K` |
+| `input.image_size` | string | 可选 | **`16:9`** | `1:1`、`3:2`、`2:3`、`4:3`、`3:4`、`16:9`、`9:16`、`21:9`。注意**默认不是 1:1** |
+| `input.output_format` | string | 可选 | `png` | `png` / `jpeg` |
+| `input.prompt_extend` | boolean | 可选 | **`true`**（推荐） | 智能提示词改写 |
+| `input.nsfw_checker` | boolean | 可选 | `false` | `false` 时关闭内容过滤，结果直接返回 |
+| `input.negative_prompt` | string | 可选 | — | 0–5000 字符。**本项目规则：绝对不显示**，不下发 |
+| `input.seed` | integer | 可选 | `1` | `[0, 2147483647]`。**本项目规则：绝对不显示**，不下发 |
+
+**图生图端点额外必填：**
+
+| 字段 | 类型 | 必填 | 说明 |
+|---|---|---|---|
+| `input.image_urls` | array | 必填 | **1–3 张**。传上传后的文件 URL。支持 `image/jpeg`、`image/png`、`image/webp`、`image/bmp`、`image/tiff`、`image/gif`；每张 ≤ 10 MB |
+
+> KIE 没有 `prompt_extend_mode`（百炼与 APIMart 有 `direct` / `agent`）。
+
+## 4. 响应结构
+
+`state=success` 后 `JSON.parse(resultJson)` → `{ "resultUrls": ["https://..."] }`。
+
+## 5. 价格
+
+来源：[KIE 定价页](https://kie.ai/pricing)（2026-08-22 读取，搜索 `qwen image 3`；1 Credit = $0.005）。
+
+**Qwen image 3.0**
+
+| 规格 | 积分 | 我们的价格 | 官方 / Fal 参考价 |
+|---|---|---|---|
+| 文生图 1K | 4.8 /张 | **$0.024/张** | $0.03 |
+| 文生图 2K | 4.8 /张 | **$0.024/张** | $0.03 |
+| 输出 1K / 2K | 4.8 /张 | **$0.024/张** | $0.03 |
+| 输入图 1K / 2K | 0.5 /张 | **$0.0025/张** | $0.003 |
+
+**Qwen image 3.0 Pro**
+
+| 规格 | 积分 | 我们的价格 | 官方 / Fal 参考价 |
+|---|---|---|---|
+| 文生图 1K | 6.4 /张 | **$0.032/张** | $0.04 |
+| 文生图 2K | 12 /张 | **$0.06/张** | $0.075 |
+| 输出 1K | 6.4 /张 | **$0.032/张** | $0.04 |
+| 输出 2K | 12 /张 | **$0.06/张** | $0.075 |
+| 输入图 1K / 2K | 0.5 /张 | **$0.0025/张** | $0.003 |
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词。KIE 本接口**两个字段都存在**，必须主动不注册、不下发。
+- `image_size` 默认 `16:9`，与其他供应商的 `1:1` 默认不同；若产品语义是「默认方形」，必须显式下发 `1:1`。
+- 比例集合含 `21:9`（APIMart 没有）。
+- `prompt_extend` 默认 `true`，与 APIMart（`false`）相反。
+- Pro 端点的 model 字符串在官方文档中自相矛盾，接入时先用两种写法各打一次任务确认。
+- `resultJson` 是 JSON 字符串，必须二次 parse。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| Qwen3 文生图 | https://docs.kie.ai/cn/market/qwen3/text-to-image | 否 |
+| Qwen3 图生图 | https://docs.kie.ai/cn/market/qwen3/image-to-image | 否 |
+| Qwen3 Pro 文生图 | https://docs.kie.ai/cn/market/qwen3-pro/text-to-image | 否 |
+| Qwen3 Pro 图生图 | https://docs.kie.ai/cn/market/qwen3-pro/image-to-image | 否 |
+| 获取任务详情 | https://docs.kie.ai/cn/market/common/get-task-detail | 否 |
+| 通用 API 快速入门 | https://docs.kie.ai/cn/common-api/quickstart | 否 |
+| 定价页（搜 `qwen image 3`） | https://kie.ai/pricing | 否 |
+| API Key 管理 | https://kie.ai/api-key | **是** |

package/docs/model-adaptation/Qwen-Image-3.0/Qwen-Image-3.0_/347/231/276/347/202/274.md

@@ -1,138 +1,138 @@
-# Qwen Image 3.0 · 百炼（阿里云百炼，官方）
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-08-30 |
-| 模态 | 图片 |
-| 供应商 | 阿里云百炼（Model Studio / DashScope），模型原厂官方接口 |
-| 平台模型 ID | `qwen-image-3.0`（标准）、`qwen-image-3.0-pro`（Pro） |
-| 接口形态 | **同步**（推荐）与**异步**两套，共用同一请求体 |
-| 文档可见性 | 公开，无需登录 |
-| 价格可见性 | 公开，无需登录 |
-
-## 1. 接入协议
-
-**必须保证模型、Endpoint URL、API Key 属于同一地域，跨地域调用会失败。**
-
-百炼已推出业务空间专属域名，`{WorkspaceId}` 为业务空间 ID（在百炼控制台业务空间详情页查看）。旧域名 `https://dashscope.aliyuncs.com` / `https://dashscope-intl.aliyuncs.com` 仍可用。
-
-### 同步调用（推荐）
-
-`POST https://{WorkspaceId}.<region>.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation`
-
-| 地域 | `<region>` |
-|---|---|
-| 华北 2（北京） | `cn-beijing` |
-| 新加坡 | `ap-southeast-1` |
-| 德国（法兰克福） | `eu-central-1` |
-| 日本（东京） | `ap-northeast-1` |
-
-### 异步调用
-
-请求头加 `X-DashScope-Async: enable`，**且换用不同的提交地址**（不要沿用同步地址）：
-
-- 提交：`POST https://{WorkspaceId}.<region>.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generation` → 返回 `task_id`
-- 查询：`GET https://{WorkspaceId}.<region>.maas.aliyuncs.com/api/v1/tasks/{task_id}`
-- `task_id` 查询有效期 24 小时；必须用提交时的**同地域、同业务空间、同 API Key** 查询
-
-### 请求头
-
-- `Content-Type: application/json`
-- `Authorization: Bearer sk-xxxx`（百炼 API Key）
-
-### 结果时效
-
-生成图像 URL **有效期 24 小时**，格式为 PNG，必须及时转存。
-
-## 2. 能力清单
-
-| 能力 | 触发方式 |
-|---|---|
-| 文生图（T2I） | `content` 仅含 1 个 `{"text": "..."}` |
-| 图生图 / 图像编辑（I2I） | `content` 含 **1–3 个** `{"image": "..."}` + 1 个 `{"text": "..."}` |
-| 提示词智能改写（DPE / APE） | `prompt_extend` + `prompt_extend_mode` |
-| 思考模式 | `enable_thinking` |
-| 多图输出 | `n` 最多 6 张 |
-
-## 3. 请求参数
-
-| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
-|---|---|---|---|---|
-| `model` | string | 必选 | — | `qwen-image-3.0-pro` 或 `qwen-image-3.0` |
-| `input.messages[0].role` | string | 必选 | — | 固定 `user`，**仅支持单轮**，数组有且只有 1 个对象 |
-| `input.messages[0].content[].image` | string | I2I 必选 | — | 输入图 URL 或 `data:{MIME_type};base64,{data}`。**I2I 支持 1–3 张**，按数组顺序定义图像顺序 |
-| `input.messages[0].content[].text` | string | 必选 | — | 正向提示词。支持中英文，推荐 ≤ 4500 Token。**只能传一个 `text`，不传或传多个会报错** |
-| `parameters.prompt_extend` | boolean | 可选 | **`true`**（建议开启） | 提示词智能改写 |
-| `parameters.prompt_extend_mode` | string | 可选 | `direct` | `direct`（DPE，T2I/I2I 都支持）；`agent`（APE，**仅 T2I**，I2I 传 `agent` 返回 400） |
-| `parameters.enable_thinking` | boolean | 可选 | `true` | 思考模式，提升质量但增加耗时。**仅在 `prompt_extend=true` 时生效**；适用于 Direct T2I / Direct I2I / Agent T2I，Agent I2I 暂不支持 |
-| `parameters.n` | integer | 可选 | `1` | 1–6 张 |
-| `parameters.size` | string | 可选 | 模型自动推荐 | `宽*高`（注意是 `*` 不是 `x`）。T2I / I2I 均为：像素面积 `512*512` ~ `2048*2048`，宽高比 `1:8` ~ `8:1` |
-| `parameters.negative_prompt` | string | 可选 | — | 反向提示词。**本项目规则：绝对不显示**，不下发 |
-| `parameters.seed` | integer | 可选 | 随机 | `[0, 2147483647]`。**本项目规则：绝对不显示**，不下发 |
-| `parameters.watermark` | boolean | 可选 | `false` | 是否加水印 |
-
-输入图像要求：格式 JPG / JPEG / PNG / BMP / TIFF / WEBP / GIF；建议宽高均在 384–2048 px；单张 ≤ 10 MB。
-
-## 4. 响应结构
-
-**同步成功**：
-
-```json
-{
-  "output": { "rewrite_status": "not_use", "choices": [ { "finish_reason": "stop",
-    "message": { "role": "assistant", "content": [ { "image": "https://dashscope-result-...png?Expires=..." } ] } } ] },
-  "usage": { "output_height": 1024, "output_width": 1024, "input_image_count": 0,
-             "input_image_type": "qima_input_1k", "output_image_count": 1, "output_image_type": "qima_output_1k" },
-  "request_id": "..."
-}
-```
-
-**异步查询**：`output.task_status` ∈ `PENDING` / `RUNNING` / `SUCCEEDED` / `FAILED` / `CANCELED` / `UNKNOWN`；成功时同样在 `output.choices[].message.content[].image` 里；失败时 `output.code` / `output.message`。同时返回 `submit_time` / `scheduled_time` / `end_time`。
-
-**计量档位**（决定价格）：`input_image_type` / `output_image_type` 按**输出分辨率像素面积**判断——面积 ≤ 2,250,000 记为 `..._1k`，> 2,250,000 记为 `..._2k`。
-
-**失败**：顶层 `code` / `message`（如 `InvalidApiKey`）。
-
-## 5. 价格（官方，人民币）
-
-来源：[百炼模型价格](https://help.aliyun.com/zh/model-studio/model-pricing)（2026-08-30 读取）。
-
-**华北 2（北京）**
-
-| 模型 | 输出分辨率 | 输入单价 | 输出单价 | 免费额度 |
-|---|---|---|---|---|
-| `qwen-image-3.0-pro` | 1k | 0.02 元/张 | **0.25 元/张** | 输入输出共 10 张 |
-| `qwen-image-3.0-pro` | 2k | 0.02 元/张 | **0.5 元/张** | 同上 |
-| `qwen-image-3.0` | 1k | 0.02 元/张 | **0.18 元/张** | 输入输出共 10 张 |
-| `qwen-image-3.0` | 2k | 0.02 元/张 | **0.18 元/张** | 同上 |
-
-**新加坡（国际）**
-
-| 模型 | 分辨率 | 输入单价 | 输出单价 |
-|---|---|---|---|
-| `qwen-image-3.0-pro` | 1k | 0.022483 元/张 | 0.299768 元/张 |
-| `qwen-image-3.0-pro` | 2k | 0.022483 元/张 | 0.562065 元/张 |
-| `qwen-image-3.0` | 1k / 2k | 0.022483 元/张 | 0.224826 元/张 |
-
-德国（法兰克福）、日本（东京）与北京同价。免费额度有效期为开通百炼 / 模型发布 / 申请通过之日起 90 天内（以较晚者为准），且**仅华北 2（北京）地域有免费额度**。
-
-## 6. 适配要点
-
-- 本项目默认**绝对不显示**：`seed`、负面提示词 `negative_prompt`。这两个字段官方**确实存在**，适配时必须主动不注册、不下发。
-- `prompt_extend` 官方默认 `true`，会改变出图效果与耗时；`enable_thinking` 默认 `true` 也会显著增加耗时。是否暴露给用户需产品决定，但默认值要与官方保持一致或显式覆盖。
-- `size` 分隔符是 `*` 不是 `x`，与火山、APIMart 的写法不同。
-- I2I 最多 3 张参考图，比 Seedream 系列少得多。
-- `qwen-image-3.0` 的 1k / 2k 同价，`qwen-image-3.0-pro` 的 2k 是 1k 的两倍价。
-- 当前 catalog 使用华北 2（北京）端点与人民币价格；新加坡价格仅用于区域资料记录，不参与北京端点的本地估价。
-- 输入图计费数量必须同时识别生成提交、画布和对话/工具面板的三套媒体字段，避免空的本地路径数组遮蔽实时图片数组而漏算输入费。
-- 同步接口足够用，异步接口地址与同步不同，接错会 404。
-
-## 7. 原始链接索引
-
-| 信息 | 链接 | 是否需登录 |
-|---|---|---|
-| 千问-图像生成与编辑 3.0 API 参考（参数、响应、异步、SDK） | https://help.aliyun.com/zh/model-studio/qwen-image-generation-and-editing-api-reference | 否 |
-| 同页文档 ID 入口（用户清单给出的链接） | https://bailian.console.aliyun.com/cn-beijing?tab=api#/api/?type=model&url=3047054 | **是**（控制台）；同内容公开页见上一行 |
-| 模型价格 | https://help.aliyun.com/zh/model-studio/model-pricing | 否 |
-| 模型列表（各地域支持情况） | https://help.aliyun.com/zh/model-studio/models | 否 |
-| API Key 获取 | https://bailian.console.aliyun.com/?apiKey=1#/api-key | **是** |
+# Qwen Image 3.0 · 百炼（阿里云百炼，官方）
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-30 |
+| 模态 | 图片 |
+| 供应商 | 阿里云百炼（Model Studio / DashScope），模型原厂官方接口 |
+| 平台模型 ID | `qwen-image-3.0`（标准）、`qwen-image-3.0-pro`（Pro） |
+| 接口形态 | **同步**（推荐）与**异步**两套，共用同一请求体 |
+| 文档可见性 | 公开，无需登录 |
+| 价格可见性 | 公开，无需登录 |
+
+## 1. 接入协议
+
+**必须保证模型、Endpoint URL、API Key 属于同一地域，跨地域调用会失败。**
+
+百炼已推出业务空间专属域名，`{WorkspaceId}` 为业务空间 ID（在百炼控制台业务空间详情页查看）。旧域名 `https://dashscope.aliyuncs.com` / `https://dashscope-intl.aliyuncs.com` 仍可用。
+
+### 同步调用（推荐）
+
+`POST https://{WorkspaceId}.<region>.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation`
+
+| 地域 | `<region>` |
+|---|---|
+| 华北 2（北京） | `cn-beijing` |
+| 新加坡 | `ap-southeast-1` |
+| 德国（法兰克福） | `eu-central-1` |
+| 日本（东京） | `ap-northeast-1` |
+
+### 异步调用
+
+请求头加 `X-DashScope-Async: enable`，**且换用不同的提交地址**（不要沿用同步地址）：
+
+- 提交：`POST https://{WorkspaceId}.<region>.maas.aliyuncs.com/api/v1/services/aigc/image-generation/generation` → 返回 `task_id`
+- 查询：`GET https://{WorkspaceId}.<region>.maas.aliyuncs.com/api/v1/tasks/{task_id}`
+- `task_id` 查询有效期 24 小时；必须用提交时的**同地域、同业务空间、同 API Key** 查询
+
+### 请求头
+
+- `Content-Type: application/json`
+- `Authorization: Bearer sk-xxxx`（百炼 API Key）
+
+### 结果时效
+
+生成图像 URL **有效期 24 小时**，格式为 PNG，必须及时转存。
+
+## 2. 能力清单
+
+| 能力 | 触发方式 |
+|---|---|
+| 文生图（T2I） | `content` 仅含 1 个 `{"text": "..."}` |
+| 图生图 / 图像编辑（I2I） | `content` 含 **1–3 个** `{"image": "..."}` + 1 个 `{"text": "..."}` |
+| 提示词智能改写（DPE / APE） | `prompt_extend` + `prompt_extend_mode` |
+| 思考模式 | `enable_thinking` |
+| 多图输出 | `n` 最多 6 张 |
+
+## 3. 请求参数
+
+| 字段 | 类型 | 必填 | 默认 | 取值与说明 |
+|---|---|---|---|---|
+| `model` | string | 必选 | — | `qwen-image-3.0-pro` 或 `qwen-image-3.0` |
+| `input.messages[0].role` | string | 必选 | — | 固定 `user`，**仅支持单轮**，数组有且只有 1 个对象 |
+| `input.messages[0].content[].image` | string | I2I 必选 | — | 输入图 URL 或 `data:{MIME_type};base64,{data}`。**I2I 支持 1–3 张**，按数组顺序定义图像顺序 |
+| `input.messages[0].content[].text` | string | 必选 | — | 正向提示词。支持中英文，推荐 ≤ 4500 Token。**只能传一个 `text`，不传或传多个会报错** |
+| `parameters.prompt_extend` | boolean | 可选 | **`true`**（建议开启） | 提示词智能改写 |
+| `parameters.prompt_extend_mode` | string | 可选 | `direct` | `direct`（DPE，T2I/I2I 都支持）；`agent`（APE，**仅 T2I**，I2I 传 `agent` 返回 400） |
+| `parameters.enable_thinking` | boolean | 可选 | `true` | 思考模式，提升质量但增加耗时。**仅在 `prompt_extend=true` 时生效**；适用于 Direct T2I / Direct I2I / Agent T2I，Agent I2I 暂不支持 |
+| `parameters.n` | integer | 可选 | `1` | 1–6 张 |
+| `parameters.size` | string | 可选 | 模型自动推荐 | `宽*高`（注意是 `*` 不是 `x`）。T2I / I2I 均为：像素面积 `512*512` ~ `2048*2048`，宽高比 `1:8` ~ `8:1` |
+| `parameters.negative_prompt` | string | 可选 | — | 反向提示词。**本项目规则：绝对不显示**，不下发 |
+| `parameters.seed` | integer | 可选 | 随机 | `[0, 2147483647]`。**本项目规则：绝对不显示**，不下发 |
+| `parameters.watermark` | boolean | 可选 | `false` | 是否加水印 |
+
+输入图像要求：格式 JPG / JPEG / PNG / BMP / TIFF / WEBP / GIF；建议宽高均在 384–2048 px；单张 ≤ 10 MB。
+
+## 4. 响应结构
+
+**同步成功**：
+
+```json
+{
+  "output": { "rewrite_status": "not_use", "choices": [ { "finish_reason": "stop",
+    "message": { "role": "assistant", "content": [ { "image": "https://dashscope-result-...png?Expires=..." } ] } } ] },
+  "usage": { "output_height": 1024, "output_width": 1024, "input_image_count": 0,
+             "input_image_type": "qima_input_1k", "output_image_count": 1, "output_image_type": "qima_output_1k" },
+  "request_id": "..."
+}
+```
+
+**异步查询**：`output.task_status` ∈ `PENDING` / `RUNNING` / `SUCCEEDED` / `FAILED` / `CANCELED` / `UNKNOWN`；成功时同样在 `output.choices[].message.content[].image` 里；失败时 `output.code` / `output.message`。同时返回 `submit_time` / `scheduled_time` / `end_time`。
+
+**计量档位**（决定价格）：`input_image_type` / `output_image_type` 按**输出分辨率像素面积**判断——面积 ≤ 2,250,000 记为 `..._1k`，> 2,250,000 记为 `..._2k`。
+
+**失败**：顶层 `code` / `message`（如 `InvalidApiKey`）。
+
+## 5. 价格（官方，人民币）
+
+来源：[百炼模型价格](https://help.aliyun.com/zh/model-studio/model-pricing)（2026-08-30 读取）。
+
+**华北 2（北京）**
+
+| 模型 | 输出分辨率 | 输入单价 | 输出单价 | 免费额度 |
+|---|---|---|---|---|
+| `qwen-image-3.0-pro` | 1k | 0.02 元/张 | **0.25 元/张** | 输入输出共 10 张 |
+| `qwen-image-3.0-pro` | 2k | 0.02 元/张 | **0.5 元/张** | 同上 |
+| `qwen-image-3.0` | 1k | 0.02 元/张 | **0.18 元/张** | 输入输出共 10 张 |
+| `qwen-image-3.0` | 2k | 0.02 元/张 | **0.18 元/张** | 同上 |
+
+**新加坡（国际）**
+
+| 模型 | 分辨率 | 输入单价 | 输出单价 |
+|---|---|---|---|
+| `qwen-image-3.0-pro` | 1k | 0.022483 元/张 | 0.299768 元/张 |
+| `qwen-image-3.0-pro` | 2k | 0.022483 元/张 | 0.562065 元/张 |
+| `qwen-image-3.0` | 1k / 2k | 0.022483 元/张 | 0.224826 元/张 |
+
+德国（法兰克福）、日本（东京）与北京同价。免费额度有效期为开通百炼 / 模型发布 / 申请通过之日起 90 天内（以较晚者为准），且**仅华北 2（北京）地域有免费额度**。
+
+## 6. 适配要点
+
+- 本项目默认**绝对不显示**：`seed`、负面提示词 `negative_prompt`。这两个字段官方**确实存在**，适配时必须主动不注册、不下发。
+- `prompt_extend` 官方默认 `true`，会改变出图效果与耗时；`enable_thinking` 默认 `true` 也会显著增加耗时。是否暴露给用户需产品决定，但默认值要与官方保持一致或显式覆盖。
+- `size` 分隔符是 `*` 不是 `x`，与火山、APIMart 的写法不同。
+- I2I 最多 3 张参考图，比 Seedream 系列少得多。
+- `qwen-image-3.0` 的 1k / 2k 同价，`qwen-image-3.0-pro` 的 2k 是 1k 的两倍价。
+- 当前 catalog 使用华北 2（北京）端点与人民币价格；新加坡价格仅用于区域资料记录，不参与北京端点的本地估价。
+- 输入图计费数量必须同时识别生成提交、画布和对话/工具面板的三套媒体字段，避免空的本地路径数组遮蔽实时图片数组而漏算输入费。
+- 同步接口足够用，异步接口地址与同步不同，接错会 404。
+
+## 7. 原始链接索引
+
+| 信息 | 链接 | 是否需登录 |
+|---|---|---|
+| 千问-图像生成与编辑 3.0 API 参考（参数、响应、异步、SDK） | https://help.aliyun.com/zh/model-studio/qwen-image-generation-and-editing-api-reference | 否 |
+| 同页文档 ID 入口（用户清单给出的链接） | https://bailian.console.aliyun.com/cn-beijing?tab=api#/api/?type=model&url=3047054 | **是**（控制台）；同内容公开页见上一行 |
+| 模型价格 | https://help.aliyun.com/zh/model-studio/model-pricing | 否 |
+| 模型列表（各地域支持情况） | https://help.aliyun.com/zh/model-studio/models | 否 |
+| API Key 获取 | https://bailian.console.aliyun.com/?apiKey=1#/api-key | **是** |

package/docs/model-adaptation/Qwen-Image-Edit-2511-/345/244/232/350/247/222/345/272/246/Qwen-Image-Edit-2511-/345/244/232/350/247/222/345/272/246_Fal.md

@@ -0,0 +1,57 @@
+# Qwen Image Edit 2511 多角度（Fal）适配资料
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-09-10 |
+| 平台 | Fal |
+| API endpoint ID | `fal-ai/qwen-image-edit-2511-multiple-angles` |
+| 模态 | 图片编辑；产品每个视角单图输入、单图输出 |
+| 价格 | $0.035 / megapixel，现有工具每视角约 1MP 估算 |
+| 登录状态 | 模型页、API 与 OpenAPI 公开；调用需要 Fal Key |
+| 接入状态 | 替换本工具的 2509 版本；真实付费图像质量尚未验证 |
+
+## 参数与产品映射
+
+| API 字段 | 类型、默认与边界 | 产品策略 |
+|---|---|---|
+| image_urls | 必填 string[]，至少 1 张 | 产品限制单张；复用 Fal 上传 |
+| horizontal_angle | number，默认 0，0..360；0 正面、90 右侧、180 背面、270 左侧 | 界面左转为正的 −180..180°，发送 `(-yaw + 360) % 360` |
+| vertical_angle | number，默认 0，−30..90；负数仰视、正数俯视 | 直接使用度数，预览与请求同号同单位 |
+| zoom | number，默认 5，0..10 | 0 全景、5 中景、10 特写 |
+| image_size | 枚举或正整数 width/height 对象；不传则继承输入尺寸 | 沿用按源图匹配最近标准比例、约 1MP 的策略；不新增输出比例控件 |
+| num_images | integer，默认 1，1..4 | 固定 1；多个视角分别请求、独立输出节点 |
+| guidance_scale | number，默认 4.5，1..20 | 隐藏，固定 4.5 |
+| num_inference_steps | integer，默认 28，1..50 | 隐藏，固定 28 |
+| lora_scale | number，默认 1，0..4 | 隐藏，固定 1 |
+| acceleration | none / regular，默认 regular | 固定 regular |
+| enable_safety_checker | boolean，默认 true | 固定 true |
+| additional_prompt | string/null，可选 | 当前节点不展示、不请求 |
+| negative_prompt / seed / sync_mode / output_format | 可选；output_format 为 png/jpeg/webp | 不展示、不请求，沿用队列与服务端默认 |
+
+2511 不支持旧版 `rotate_right_left`、`move_forward`、`wide_angle_lens`，不可继续透传。移除广角开关。拖动过程中只更新局部预览，松手才吸附近邻常用角度并提交配置。
+
+模型根据 horizontal_angle、vertical_angle、zoom 构造 `<sks>` 视角描述提示词，再由多角度 LoRA 生成。参数表示目标视角，不保证测量级几何精度。
+
+## 请求与异步协议
+
+- 提交：`POST https://queue.fal.run/fal-ai/qwen-image-edit-2511-multiple-angles`，鉴权 `Authorization: Key <FAL_KEY>`。
+- 复用 [Fal 公共队列契约](../供应商/Fal.md#2-队列契约)，根据响应 status_url / response_url 轮询和取结果，不复制状态机。
+- 成功输出：`images[].url`、`seed`、`prompt` 必填。图片元数据可缺失或 null；url 必填。
+- 空图、多图、终态错误和取消仍走现有多角度批次与 Fal provider 失败处理；不会自动补发付费请求。
+
+| 事件 | 前置状态 → 后续状态 | 输出/边界 |
+|---|---|---|
+| submit | 新请求 → IN_QUEUE 或 IN_PROGRESS | request_id、status_url；记录请求归属 |
+| status | 等待 → IN_QUEUE / IN_PROGRESS | 不提取最终图片；继续公共轮询 |
+| status COMPLETED | 等待 → 拉取结果 | 按 response_url 取结果 |
+| result | 拉取结果 → completed | images[].url；保存独立视角结果 |
+| HTTP/业务失败、空结果 | 提交/等待/取结果 → failed | 公共错误映射；不静默成功 |
+| cancel/超时 | 活跃 → cancelled/failed | 复用现有取消、轮询上限与资源释放 |
+
+`packages/ai-sdk/tests/fixtures/fal-tools/qwen-image-edit-2511-multiple-angles.json` 包含 2026-09-10 原样抓取的官方 input/output schema。请求和队列响应为明确标注的字段表构造离线夹具，不代表真实付费调用。对应精确测试覆盖默认值、仰视/顶视、上传、路由、轮询和图片提取；画布策略测试覆盖左右方向与三维姿态映射。
+
+## 原始链接索引
+
+- [模型页与价格](https://fal.ai/models/fal-ai/qwen-image-edit-2511-multiple-angles)：公开，$0.035/MP。
+- [API 字段与提示词构造说明](https://fal.ai/models/fal-ai/qwen-image-edit-2511-multiple-angles/api)：公开。
+- [官方 OpenAPI](https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=fal-ai/qwen-image-edit-2511-multiple-angles)：公开，范围、默认值、required/nullable；本次实际采集。