@henjicc/ai-sdk 0.9.0 → 0.10.0

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

@@ -1,57 +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；本次实际采集。
+# 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；本次实际采集。

package/docs/model-adaptation/Qwen-MT-Flash/Qwen-MT-Flash_/347/231/276/347/202/274.md

@@ -1,68 +1,68 @@
-# Qwen-MT-Flash · 百炼
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-09-24 |
-| 能力 | 文本翻译（增量流式 / 非流式） |
-| 平台模型 ID | `qwen-mt-flash` |
-| 地域 | 北京、新加坡、美国（弗吉尼亚）、德国（法兰克福）；以区域模型实际开通为准 |
-| 文档/价格 | API/价格公开；选型页本次触发验证码 |
-
-## 1. 协议与参数
-
-```text
-POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/chat/completions
-POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation
-Authorization: Bearer <API Key>
-```
-
-只支持 User Message，`content` 是待翻译文本。`translation_options` 必填：`source_lang` 为源语言英文全称或 `auto`，`target_lang` 为目标语言英文全称；可选 `terms/tm_list/domains`，其中领域提示只支持英文。
-
-支持 `stream/max_tokens/seed/temperature/top_p/top_k/repetition_penalty`。官方 API 页将 `max_tokens` 上限指向选型页，但选型页本次被验证码拦截，**未获得可核实的独立上限，实现不得凭经验硬编数字**。
-
-## 2. 结果、流式与价格
-
-非流式译文为 `choices[0].message.content`，用量为 `usage.prompt_tokens/completion_tokens/total_tokens`。Flash 的 SSE `delta.content` 是**增量片段**，客户端直接追加。
-
-北京官方原价：输入 0.7 元/百万 Token，输出 1.95 元/百万 Token；价格页列北京限时 100 万 Token 免费额度，以账号实际为准。
-
-## 3. 适配要点
-
-翻译是独立 capability，不用通用 LLM prompt 伪装；但可复用 OpenAI 兼容传输与 SSE 解析。只在按需注册翻译能力时暴露，不得因为 SDK 内置就强制进入所有宿主。
-
-## 4. SDK 实现状态
-
-- 按需入口：`@henjicc/ai-sdk/capabilities/translation/bailian`，工厂 `createQwenMtFlashTranslationModule()`。
-- 默认走 OpenAI 兼容 Chat Completions 并开启 SSE；将官方增量块统一成 `delta(mode=append)`，最终输出完整 `item`，Token 计入 `usage`。
-- Say-It 当前保存的常用语言代码会先映射为官方英文语言名；术语表映射到 `terms`，翻译记忆映射到 `tm_list`，通用 `context` 映射到英文领域提示 `domains`。
-- 未核实的独立最大输出数不设默认值，也不发送 `max_tokens`。当前只有官方示例 fixture/单测证据，尚无真实付费请求证据。
-
-### 三模型共享事件契约与回归矩阵（2026-09-24）
-
-本节只复核响应及生命周期，价格和输入上限未重新调研。依据同页 OpenAI 兼容 API 的流式/非流式响应定义：Flash/Lite 增量、Plus 累积；生成中 `finish_reason=null`，自然结束为 `stop`，长度截断为 `length`。官方样例包含空首帧、两次相同 `stop` 帧及 `choices=[]` 用量帧。
-
-| 事件/序列 | SDK 行为 | 回归依据 |
-|---|---|---|
-| 空 `content` 中间块、连续增量/累积内容 | 等待或更新部分结果，不报失败 | 官方 fixture；既有三模型测试 |
-| 重复 `stop` + 独立 usage + DONE/正常 EOF | 只产出一次完整 item；累计模型重复最终快照不重复追加 | fixture 补齐官方重复结束块；生命周期测试 |
-| 空 `choices` 且有用量 | 用量通知，不作为完成依据 | 官方 usage 块 |
-| 部分结果后 DONE/EOF、末块无空行 | 缺少可分发最终块时报 `provider_response_invalid`；不补造 SSE 空行 | 删除结束块/截断分隔符的受控变异 |
-| `length`（流式及非流式） | `provider_task_failed`，details 保留 `finishReason=length`；不把截断译文作为完整 item | 官方枚举的受控变异 |
-| 缺少 choices/content/结束原因，字段错类型，最终内容继续变化 | 明确拒绝，不作为空状态通知跳过 | 从官方结果块移除或替换字段 |
-| 错误对象缺少 code、SSE `event:error`、HTTP 错误 | 明确失败，保留实际模型/协议/阶段及安全错误码；不默认输出原始 message | 错误 envelope 的受控注入 |
-| 未知具名 SSE 扩展事件 | 不提供成功或失败依据；继续等已知协议结果 | 扩展通知 + 正常/缺失结束序列 |
-| 取消、断流、回调失败、DONE 后连接未关闭 | 中止或失败，取消剩余流并释放锁；取消后不再发送 item/completed | Mock 流与取消回放 |
-
-`content` 必须是字符串，但不凭经验添加“最终译文必须非空”的限制；空输入本地短路仍受取消约束。SSE 分帧与聊天共用 `src/protocols/sse-events.ts`，结果校验和增量/累积语义保持在各适配器内。
-
-证据：`tests/fixtures/bailian-translation/official-qwen-mt-examples.json`、`tests/bailian-qwen-mt.test.ts`、`tests/bailian-qwen-mt-lifecycle.test.ts`。负例是明确标注的受控变异，不声称来自真实付费请求。
-
-## 5. 原始链接索引
-
-| 信息 | 链接 | 登录 |
-|---|---|---|
-| API/请求/响应 | https://help.aliyun.com/zh/model-studio/qwen-mt-api | 否 |
-| SSE 分帧与 EOF | https://html.spec.whatwg.org/multipage/server-sent-events.html#event-stream-interpretation | 否 |
-| 选型/语言/限制 | https://help.aliyun.com/zh/model-studio/machine-translation | 否（本次访问触发验证码，未取正文） |
-| 价格 | https://help.aliyun.com/zh/model-studio/model-pricing | 否 |
-| API Key | https://bailian.console.aliyun.com/?apiKey=1#/api-key | **是** |
+# Qwen-MT-Flash · 百炼
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-09-24 |
+| 能力 | 文本翻译（增量流式 / 非流式） |
+| 平台模型 ID | `qwen-mt-flash` |
+| 地域 | 北京、新加坡、美国（弗吉尼亚）、德国（法兰克福）；以区域模型实际开通为准 |
+| 文档/价格 | API/价格公开；选型页本次触发验证码 |
+
+## 1. 协议与参数
+
+```text
+POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/chat/completions
+POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/text-generation/generation
+Authorization: Bearer <API Key>
+```
+
+只支持 User Message，`content` 是待翻译文本。`translation_options` 必填：`source_lang` 为源语言英文全称或 `auto`，`target_lang` 为目标语言英文全称；可选 `terms/tm_list/domains`，其中领域提示只支持英文。
+
+支持 `stream/max_tokens/seed/temperature/top_p/top_k/repetition_penalty`。官方 API 页将 `max_tokens` 上限指向选型页，但选型页本次被验证码拦截，**未获得可核实的独立上限，实现不得凭经验硬编数字**。
+
+## 2. 结果、流式与价格
+
+非流式译文为 `choices[0].message.content`，用量为 `usage.prompt_tokens/completion_tokens/total_tokens`。Flash 的 SSE `delta.content` 是**增量片段**，客户端直接追加。
+
+北京官方原价：输入 0.7 元/百万 Token，输出 1.95 元/百万 Token；价格页列北京限时 100 万 Token 免费额度，以账号实际为准。
+
+## 3. 适配要点
+
+翻译是独立 capability，不用通用 LLM prompt 伪装；但可复用 OpenAI 兼容传输与 SSE 解析。只在按需注册翻译能力时暴露，不得因为 SDK 内置就强制进入所有宿主。
+
+## 4. SDK 实现状态
+
+- 按需入口：`@henjicc/ai-sdk/capabilities/translation/bailian`，工厂 `createQwenMtFlashTranslationModule()`。
+- 默认走 OpenAI 兼容 Chat Completions 并开启 SSE；将官方增量块统一成 `delta(mode=append)`，最终输出完整 `item`，Token 计入 `usage`。
+- Say-It 当前保存的常用语言代码会先映射为官方英文语言名；术语表映射到 `terms`，翻译记忆映射到 `tm_list`，通用 `context` 映射到英文领域提示 `domains`。
+- 未核实的独立最大输出数不设默认值，也不发送 `max_tokens`。当前只有官方示例 fixture/单测证据，尚无真实付费请求证据。
+
+### 三模型共享事件契约与回归矩阵（2026-09-24）
+
+本节只复核响应及生命周期，价格和输入上限未重新调研。依据同页 OpenAI 兼容 API 的流式/非流式响应定义：Flash/Lite 增量、Plus 累积；生成中 `finish_reason=null`，自然结束为 `stop`，长度截断为 `length`。官方样例包含空首帧、两次相同 `stop` 帧及 `choices=[]` 用量帧。
+
+| 事件/序列 | SDK 行为 | 回归依据 |
+|---|---|---|
+| 空 `content` 中间块、连续增量/累积内容 | 等待或更新部分结果，不报失败 | 官方 fixture；既有三模型测试 |
+| 重复 `stop` + 独立 usage + DONE/正常 EOF | 只产出一次完整 item；累计模型重复最终快照不重复追加 | fixture 补齐官方重复结束块；生命周期测试 |
+| 空 `choices` 且有用量 | 用量通知，不作为完成依据 | 官方 usage 块 |
+| 部分结果后 DONE/EOF、末块无空行 | 缺少可分发最终块时报 `provider_response_invalid`；不补造 SSE 空行 | 删除结束块/截断分隔符的受控变异 |
+| `length`（流式及非流式） | `provider_task_failed`，details 保留 `finishReason=length`；不把截断译文作为完整 item | 官方枚举的受控变异 |
+| 缺少 choices/content/结束原因，字段错类型，最终内容继续变化 | 明确拒绝，不作为空状态通知跳过 | 从官方结果块移除或替换字段 |
+| 错误对象缺少 code、SSE `event:error`、HTTP 错误 | 明确失败，保留实际模型/协议/阶段及安全错误码；不默认输出原始 message | 错误 envelope 的受控注入 |
+| 未知具名 SSE 扩展事件 | 不提供成功或失败依据；继续等已知协议结果 | 扩展通知 + 正常/缺失结束序列 |
+| 取消、断流、回调失败、DONE 后连接未关闭 | 中止或失败，取消剩余流并释放锁；取消后不再发送 item/completed | Mock 流与取消回放 |
+
+`content` 必须是字符串，但不凭经验添加“最终译文必须非空”的限制；空输入本地短路仍受取消约束。SSE 分帧与聊天共用 `src/protocols/sse-events.ts`，结果校验和增量/累积语义保持在各适配器内。
+
+证据：`tests/fixtures/bailian-translation/official-qwen-mt-examples.json`、`tests/bailian-qwen-mt.test.ts`、`tests/bailian-qwen-mt-lifecycle.test.ts`。负例是明确标注的受控变异，不声称来自真实付费请求。
+
+## 5. 原始链接索引
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| API/请求/响应 | https://help.aliyun.com/zh/model-studio/qwen-mt-api | 否 |
+| SSE 分帧与 EOF | https://html.spec.whatwg.org/multipage/server-sent-events.html#event-stream-interpretation | 否 |
+| 选型/语言/限制 | https://help.aliyun.com/zh/model-studio/machine-translation | 否（本次访问触发验证码，未取正文） |
+| 价格 | https://help.aliyun.com/zh/model-studio/model-pricing | 否 |
+| API Key | https://bailian.console.aliyun.com/?apiKey=1#/api-key | **是** |

package/docs/model-adaptation/Qwen-MT-Lite/Qwen-MT-Lite_/347/231/276/347/202/274.md

@@ -1,40 +1,40 @@
-# Qwen-MT-Lite · 百炼
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-09-24 |
-| 能力 | 文本翻译（增量流式 / 非流式） |
-| 平台模型 ID | `qwen-mt-lite` |
-| 地域 | 北京、新加坡、美国（弗吉尼亚）、德国（法兰克福）；以实际开通为准 |
-| 文档/价格 | API/价格公开；选型页本次触发验证码 |
-
-## 1. 协议、参数与结果
-
-OpenAI 兼容 `POST /compatible-mode/v1/chat/completions` 或 DashScope `POST /api/v1/services/aigc/text-generation/generation`，Bearer 鉴权。只支持 User Message。
-
-`translation_options` 必填 `source_lang/target_lang`，源语言可 `auto`；可选 `terms/tm_list/domains`。支持 `stream/max_tokens/seed/temperature/top_p/top_k/repetition_penalty`。API 页引用的选型页本次触发验证码，所以独立 `max_tokens` 数值未核实，不硬编。
-
-非流式结果为 `choices[0].message.content`；Lite 的 SSE `delta.content` 为**增量片段**，可直接追加。用量从 `usage` 读取。
-
-## 2. 价格与适配
-
-北京官方原价：输入 0.6 元/百万 Token，输出 1.6 元/百万 Token；价格页列 100 万 Token 限时免费额度。
-
-翻译 capability 单独注册，宿主可只选 Lite 而不引入 Plus/Flash。密钥、待翻译原文、完整译文均默认不记入常规日志。
-
-## 3. SDK 实现状态
-
-- 按需入口：`@henjicc/ai-sdk/capabilities/translation/bailian`，工厂 `createQwenMtLiteTranslationModule()`。
-- 默认走 OpenAI 兼容 SSE；官方增量块归一为追加事件，使用 SDK 自带 UTF-8 增量解码器，不要求 UXP 等宿主提供 `TextDecoder`。
-- 支持 usage、术语、翻译记忆、领域提示、Say-It 常用语言代码兼容；密钥、原文和译文不写入结构化日志。
-- 未核实的独立最大输出数不设默认值，也不发送 `max_tokens`。当前只有官方示例 fixture/单测证据，尚无真实付费请求证据。
-- 2026-09-24 复核结束语义、合法空帧、用量、错误、截断及取消；详见 [三模型共享事件契约与回归矩阵](../Qwen-MT-Flash/Qwen-MT-Flash_百炼.md#三模型共享事件契约与回归矩阵2026-09-24)。Lite 保持增量拼接，错误诊断保留实际 `qwen-mt-lite` 模型名。
-
-## 4. 原始链接索引
-
-| 信息 | 链接 | 登录 |
-|---|---|---|
-| API/流式差异 | https://help.aliyun.com/zh/model-studio/qwen-mt-api | 否 |
-| 选型/限制 | https://help.aliyun.com/zh/model-studio/machine-translation | 否（本次触发验证码） |
-| 价格 | https://help.aliyun.com/zh/model-studio/model-pricing | 否 |
-| API Key | https://bailian.console.aliyun.com/?apiKey=1#/api-key | **是** |
+# Qwen-MT-Lite · 百炼
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-09-24 |
+| 能力 | 文本翻译（增量流式 / 非流式） |
+| 平台模型 ID | `qwen-mt-lite` |
+| 地域 | 北京、新加坡、美国（弗吉尼亚）、德国（法兰克福）；以实际开通为准 |
+| 文档/价格 | API/价格公开；选型页本次触发验证码 |
+
+## 1. 协议、参数与结果
+
+OpenAI 兼容 `POST /compatible-mode/v1/chat/completions` 或 DashScope `POST /api/v1/services/aigc/text-generation/generation`，Bearer 鉴权。只支持 User Message。
+
+`translation_options` 必填 `source_lang/target_lang`，源语言可 `auto`；可选 `terms/tm_list/domains`。支持 `stream/max_tokens/seed/temperature/top_p/top_k/repetition_penalty`。API 页引用的选型页本次触发验证码，所以独立 `max_tokens` 数值未核实，不硬编。
+
+非流式结果为 `choices[0].message.content`；Lite 的 SSE `delta.content` 为**增量片段**，可直接追加。用量从 `usage` 读取。
+
+## 2. 价格与适配
+
+北京官方原价：输入 0.6 元/百万 Token，输出 1.6 元/百万 Token；价格页列 100 万 Token 限时免费额度。
+
+翻译 capability 单独注册，宿主可只选 Lite 而不引入 Plus/Flash。密钥、待翻译原文、完整译文均默认不记入常规日志。
+
+## 3. SDK 实现状态
+
+- 按需入口：`@henjicc/ai-sdk/capabilities/translation/bailian`，工厂 `createQwenMtLiteTranslationModule()`。
+- 默认走 OpenAI 兼容 SSE；官方增量块归一为追加事件，使用 SDK 自带 UTF-8 增量解码器，不要求 UXP 等宿主提供 `TextDecoder`。
+- 支持 usage、术语、翻译记忆、领域提示、Say-It 常用语言代码兼容；密钥、原文和译文不写入结构化日志。
+- 未核实的独立最大输出数不设默认值，也不发送 `max_tokens`。当前只有官方示例 fixture/单测证据，尚无真实付费请求证据。
+- 2026-09-24 复核结束语义、合法空帧、用量、错误、截断及取消；详见 [三模型共享事件契约与回归矩阵](../Qwen-MT-Flash/Qwen-MT-Flash_百炼.md#三模型共享事件契约与回归矩阵2026-09-24)。Lite 保持增量拼接，错误诊断保留实际 `qwen-mt-lite` 模型名。
+
+## 4. 原始链接索引
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| API/流式差异 | https://help.aliyun.com/zh/model-studio/qwen-mt-api | 否 |
+| 选型/限制 | https://help.aliyun.com/zh/model-studio/machine-translation | 否（本次触发验证码） |
+| 价格 | https://help.aliyun.com/zh/model-studio/model-pricing | 否 |
+| API Key | https://bailian.console.aliyun.com/?apiKey=1#/api-key | **是** |