@henjicc/ai-sdk 0.2.8

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

@@ -0,0 +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 | **是** |

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

@@ -0,0 +1,116 @@
+# Qwen Image Edit 2509 多角度（Fal）适配资料
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-29 |
+| 平台 | Fal |
+| 展示名 | Qwen Image Edit 2509 Lora Gallery / Multiple Angles |
+| API endpoint ID | `fal-ai/qwen-image-edit-2509-lora-gallery/multiple-angles` |
+| 模态 | 单图输入 → 单角度编辑图 |
+| 商用标记 | Fal 模型页明确标为 `Commercial use` |
+| 价格 | `$0.035 / megapixel` |
+| 登录状态 | 模型页、Agent 文本与 OpenAPI 公开；真实调用需要 Fal Key |
+| 接入状态 | 已完成静态契约，待任务 4.4 实现与真实付费质量验证 |
+
+> 本端点虽然用“角度”和“度数”描述部分输入，但没有输出相机内参、外参或几何误差。产品侧只能称为“模型控制角”，不能称为测量级相机姿态。
+
+## 1. 接口与异步协议
+
+- 直连：`POST https://fal.run/fal-ai/qwen-image-edit-2509-lora-gallery/multiple-angles`
+- 队列提交：`POST https://queue.fal.run/fal-ai/qwen-image-edit-2509-lora-gallery/multiple-angles`
+- 鉴权：`Authorization: Key <FAL_KEY>`
+- 生产模式：复用 Fal 供应商公共队列、轮询、取消、结果解析和 Fal CDN 上传，不新增协议实现。
+- 结果路径：`images[].url`；同时返回 `seed`。
+
+队列事件契约、官方 fixture 与现有 parser 边界沿用 [Fal 供应商资料](../供应商/Fal.md#2-队列契约)。本模型没有新增状态或响应协议；任务 4.4 只需补请求构建与模型精确测试，不应复制 Fal 队列状态机。
+
+## 2. 请求字段
+
+| 字段 | 类型 | 必填 | 默认 | 范围/枚举 | 产品策略 |
+|---|---|---|---|---|---|
+| `image_urls` | `string[]` | 是 | — | 官方未给最大数量 | 产品固定 1 张输入图，由 Fal 官方上传链路生成 URL |
+| `image_size` | 尺寸枚举或 `{width,height}` | 否 | 保留最终输入图尺寸 | `square_hd`、`square`、`portrait_4_3`、`portrait_16_9`、`landscape_4_3`、`landscape_16_9` 或正整数尺寸 | 首版根据输入比例映射到约 1MP 的标准档，限制费用，不直接沿用超大输入尺寸 |
+| `guidance_scale` | number | 否 | `1` | `0..20` | 隐藏，固定 `1` |
+| `num_inference_steps` | integer | 否 | `6` | `2..50` | 隐藏，固定 `6` |
+| `acceleration` | string | 否 | `regular` | `none` / `regular` | 隐藏，固定 `regular` |
+| `negative_prompt` | string | 否 | 单个空格 | — | 不显示、不请求 |
+| `seed` | integer/null | 否 | — | — | 不显示、不请求 |
+| `sync_mode` | boolean | 否 | `false` | — | 不显示、不请求，沿用队列 |
+| `enable_safety_checker` | boolean | 否 | `true` | — | 隐藏，固定 `true` |
+| `output_format` | string | 否 | `png` | `png` / `jpeg` / `webp` | 不显示、不请求，沿用项目约定 |
+| `num_images` | integer | 否 | `1` | `1..4` | 隐藏，固定 `1`；多角度由多个不同控制参数请求组成，不能用同角度变体冒充多视角 |
+| `rotate_right_left` | number | 否 | `0` | `-90..90` 度；正值向左、负值向右 | 作为水平“模型控制角”展示并发送 |
+| `move_forward` | number | 否 | `0` | `0..10` | 作为近摄程度；不能表达后退或远景 |
+| `vertical_angle` | number | 否 | `0` | `-1..1`；`-1` 鸟瞰、`1` 仰视 | 使用语义刻度，不显示为度数 |
+| `wide_angle_lens` | boolean | 否 | `false` | — | 作为广角开关；不能冒充远距离 |
+| `lora_scale` | number | 否 | `1.25` | `0..4` | 隐藏，固定 `1.25` |
+
+### 产品输入顺序
+
+1. 输入图片（固定 1 张）
+2. 控制档：连续镜头
+3. 视角集合（默认 4，首版 `1..6`）
+4. 水平模型控制角
+5. 俯拍/仰拍
+6. 近摄程度
+7. 广角开关
+
+本端点**没有提示词字段**。首版正式界面不得展示一个不会进入请求的提示词输入；数据结构可为未来其它控制档保留可选字段，但当前档必须标为不可用并不持久化无效输入。
+
+## 3. 首版请求映射
+
+每个选择的目标视角产生一次独立 Fal 请求：
+
+```json
+{
+  "image_urls": ["<Fal CDN URL>"],
+  "image_size": "landscape_4_3",
+  "guidance_scale": 1,
+  "num_inference_steps": 6,
+  "acceleration": "regular",
+  "enable_safety_checker": true,
+  "num_images": 1,
+  "rotate_right_left": -45,
+  "move_forward": 0,
+  "vertical_angle": 0,
+  "wide_angle_lens": false,
+  "lora_scale": 1.25
+}
+```
+
+`image_size` 根据第一张输入图比例选最接近的标准档：方形、4:3、16:9 及其竖向版本。生成结果的实际像素数必须用于最终费用记录；静态估价按不超过约 1MP/张计算。
+
+## 4. 输出与失败边界
+
+- 单次请求期望 `images.length === 1`；零张或多张都视为该视角契约不符，不静默截断。
+- 一组多角度结果按用户选择顺序保存，标签来自请求前的相机控制数据，不从文件名或结果顺序重新推断。
+- 多角度批次可并发最多 2 个请求；所有视角完成后才交给画布多结果事务落图。
+- 某个视角失败时不提交半成品结果组；节点保留每个视角的状态和已完成 URL，以便只重试失败项，避免重复付费。
+- 模型没有物理几何保证；输出标签要同时保存 `controlPrecision: learned-native`。
+
+## 5. 价格与预算
+
+- 官方标价：`$0.035 / megapixel`。
+- 首版固定约 1MP：单视角预算上限按 `$0.035` 估算。
+- 默认 4 视角：约 `$0.14`；首版最大 6 视角：约 `$0.21`。
+- 最终账单可能受实际输出像素和账户价格影响，真实调用后应按 Fal billing event / request ID 对账。
+- 官方未给延迟承诺；真实验收需记录每个 request ID 的排队、生成和总耗时。
+
+## 6. 待真实验证
+
+- 水平角度数值与视觉角度的误差分布，尤其是人物、非对称商品和建筑。
+- 多次独立请求的身份、服装、纹理、文字、背景与几何一致性。
+- `vertical_angle` 的有效分辨率与极值稳定性。
+- `move_forward` 是否会改变主体身份或仅改变构图。
+- 标准尺寸映射的真实像素与计费单位。
+- 取消、单项重试和已完成 URL 的有效期。
+
+## 7. 原始链接索引
+
+| 内容 | 链接 | 是否需登录 | 核查日期 |
+|---|---|---|---|
+| 模型页、商用标记与价格 | https://fal.ai/models/fal-ai/qwen-image-edit-2509-lora-gallery/multiple-angles | 否 | 2026-08-29 |
+| 实时 Agent 文本（字段、价格、示例） | https://fal.ai/models/fal-ai/qwen-image-edit-2509-lora-gallery/multiple-angles/llms.txt | 否 | 2026-08-29 |
+| OpenAPI（完整枚举、范围、必填与响应） | https://fal.ai/api/openapi/queue/openapi.json?endpoint_id=fal-ai/qwen-image-edit-2509-lora-gallery/multiple-angles | 否 | 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 | 否 | 2026-08-29 |

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

@@ -0,0 +1,47 @@
+# Qwen-MT-Flash · 百炼
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-28 |
+| 能力 | 文本翻译（增量流式 / 非流式） |
+| 平台模型 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/单测证据，尚无真实付费请求证据。
+
+## 5. 原始链接索引
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| 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 | **是** |

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

@@ -0,0 +1,39 @@
+# Qwen-MT-Lite · 百炼
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-28 |
+| 能力 | 文本翻译（增量流式 / 非流式） |
+| 平台模型 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/单测证据，尚无真实付费请求证据。
+
+## 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 | **是** |

package/docs/model-adaptation/Qwen-MT-Plus/Qwen-MT-Plus_/347/231/276/347/202/274.md

@@ -0,0 +1,39 @@
+# Qwen-MT-Plus · 百炼
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-28 |
+| 能力 | 文本翻译（非流式 / 累积流式） |
+| 平台模型 ID | `qwen-mt-plus` |
+| 地域 | 北京、新加坡、美国（弗吉尼亚）、德国（法兰克福）；以实际开通为准 |
+| 文档/价格 | 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`。Plus 开启流式时，官方明确每块返回当前**累积序列**，而不是新增文本；客户端应替换当前候选或计算前缀差，不能直接追加。
+
+## 2. 价格与适配
+
+北京官方原价：输入 1.8 元/百万 Token，输出 5.4 元/百万 Token；价格页列 100 万 Token 限时免费额度。
+
+实现必须为不同模型声明流式 delta 语义，不用同一个“字符串追加”分支处理 Flash/Lite/Plus。按需注册，不强制宿主安装全部模型。
+
+## 3. SDK 实现状态
+
+- 按需入口：`@henjicc/ai-sdk/capabilities/translation/bailian`，工厂 `createQwenMtPlusTranslationModule()`。
+- 默认走 OpenAI 兼容 SSE；SDK 对官方累积序列计算前缀差，正常情况统一发 `delta(mode=append)`，供应商改写既有前缀时明确发 `mode=replace`，最终 `item` 始终是完整译文。
+- 支持单条/带稳定 id 的批量输入、usage 汇总、术语、翻译记忆、领域提示以及 Say-It 常用语言代码兼容。
+- 未核实的独立最大输出数不设默认值，也不发送 `max_tokens`。当前只有官方示例 fixture/单测证据，尚无真实付费请求证据。
+
+## 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 | **是** |

package/docs/model-adaptation/Qwen3-ASR-Flash/Qwen3-ASR-Flash_/347/231/276/347/202/274.md

@@ -0,0 +1,40 @@
+# Qwen3-ASR-Flash · 百炼
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-28 |
+| 能力 | 短音频同步识别（OpenAI 兼容 / DashScope HTTP） |
+| 平台模型 ID | `qwen3-asr-flash`（稳定别名，官方当前等同 `qwen3-asr-flash-2025-09-08`） |
+| 输入上限 | 5 分钟 / 10 MB，单次 1 个音频 |
+| 文档/价格 | 公开，无需登录 |
+
+## 1. 接入协议
+
+推荐 Say-It 复用 OpenAI 兼容协议：
+
+```text
+POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/chat/completions
+Authorization: Bearer <API Key>
+```
+
+`messages[].content[]` 传 `{type:"input_audio", input_audio:{data}}`，`data` 支持公网 URL 或 Base64 Data URI。`asr_options` 是非 OpenAI 标准参数，支持 `language` 和 `enable_itn`。也可用 DashScope 同步端点 `/api/v1/services/aigc/multimodal-generation/generation`。
+
+非流式结果为 `choices[0].message.content`；SSE 为 `choices[0].delta.content`，最后 usage 块需单独处理。DashScope 结果在 `output.choices[]`。
+
+## 2. 能力与价格
+
+- 支持多语种/中文方言、情感识别、ITN；不支持热词和说话人分离。
+- 北京原价 0.00022 元/秒，输出不计费；官方列 36,000 秒/10 小时限时免费额度。
+
+## 3. 适配要点
+
+稳定别名与 2026-02-10 快照并列注册，不自动改写模型 ID。该模型 10 MB 上限明显低于 Fun-ASR-Flash；上传前必须先按模型限制校验，不能只按通用上传的 1 GB 上限。
+
+## 4. 原始链接索引
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| API | https://help.aliyun.com/zh/model-studio/qwen-asr-api-reference | 否 |
+| 模型/音频规格 | https://help.aliyun.com/zh/model-studio/asr-model/ | 否 |
+| 价格 | https://help.aliyun.com/zh/model-studio/model-pricing | 否 |
+| API Key | https://bailian.console.aliyun.com/?apiKey=1#/api-key | **是** |

package/docs/model-adaptation/Qwen3-ASR-Flash-2026-02-10/Qwen3-ASR-Flash-2026-02-10_/347/231/276/347/202/274.md

@@ -0,0 +1,33 @@
+# Qwen3-ASR-Flash-2026-02-10 · 百炼
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-28 |
+| 能力 | 短音频同步识别（OpenAI 兼容 / DashScope HTTP） |
+| 平台模型 ID | `qwen3-asr-flash-2026-02-10`（最新快照） |
+| 输入上限 | 5 分钟 / 10 MB，单次 1 个音频 |
+| 文档/价格 | 公开，无需登录 |
+
+## 1. 端点、输入与结果
+
+`POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1/chat/completions`，Bearer 鉴权。用 `messages[].content[].input_audio.data` 传公网 URL 或 Base64 Data URI；`asr_options` 可传 `language/enable_itn`。
+
+同步结果 `choices[0].message.content`，SSE 结果 `choices[0].delta.content`。备选 DashScope 端点为 `/api/v1/services/aigc/multimodal-generation/generation`，请求/结果包装与 OpenAI 不同。
+
+## 2. 能力与价格
+
+多语种/中文方言，支持情感识别和 ITN；不支持热词/说话人分离。北京原价 0.00022 元/秒，输出不计费；官方列 36,000 秒/10 小时限时免费额度。
+
+## 3. 适配要点
+
+与稳定别名共用请求实现，但分开注册和展示。小文件优先 Base64；如用百炼临时 OSS，必须按本精确模型 ID 申请上传凭证，并加 `X-DashScope-OssResourceResolve: enable`。
+
+## 4. 原始链接索引
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| API | https://help.aliyun.com/zh/model-studio/qwen-asr-api-reference | 否 |
+| 模型/音频规格 | https://help.aliyun.com/zh/model-studio/asr-model/ | 否 |
+| 临时上传 | https://help.aliyun.com/zh/model-studio/get-temporary-file-url | 否 |
+| 价格 | https://help.aliyun.com/zh/model-studio/model-pricing | 否 |
+| API Key | https://bailian.console.aliyun.com/?apiKey=1#/api-key | **是** |

package/docs/model-adaptation/Qwen3-ASR-Flash-Filetrans/Qwen3-ASR-Flash-Filetrans_/347/231/276/347/202/274.md

@@ -0,0 +1,41 @@
+# Qwen3-ASR-Flash-Filetrans · 百炼
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-28 |
+| 能力 | 长音频/录音文件异步识别 |
+| 平台模型 ID | `qwen3-asr-flash-filetrans` |
+| 输入上限 | 12 小时 / 2 GB；单次 1 个 URL |
+| 文档/价格 | 公开，无需登录 |
+
+## 1. 提交与轮询
+
+```text
+POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/asr/transcription
+Authorization: Bearer <API Key>
+X-DashScope-Async: enable
+GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}
+```
+
+提交 `model="qwen3-asr-flash-filetrans"`、`input.file_url`；可选 `parameters.language/enable_itn/enable_words/channel_id`。返回 `task_id`，轮询状态 `PENDING/RUNNING/SUCCEEDED/FAILED/UNKNOWN`。成功返回的转写结果需及时持久化，不把任务或签名 URL 当长期资源。
+
+## 2. 能力、上传与价格
+
+- 多语种/中文方言，支持情感识别、ITN 和句/字时间戳；不支持热词和说话人分离。
+- 格式 `aac/amr/avi/flac/flv/m4a/mkv/mov/mp3/mp4/mpeg/ogg/opus/wav/webm/wma/wmv`，采样率任意。
+- 需公网 URL；REST 可用百炼 48 小时 `oss://` 临时 URL，调用时加 `X-DashScope-OssResourceResolve: enable`。
+- `channel_id` 每个音轨独立计费。北京原价 0.00022 元/秒，输出不计费；官方列 36,000 秒/10 小时限时免费额度。
+
+## 3. 适配要点
+
+该 ID 只支持 DashScope 异步，不得经 OpenAI 兼容 Chat 端点发送。宿主层负责文件上传和长轮询生命周期，SDK 返回结构化转写结果。用户取消时停止轮询；如官方取消 API 可用，后续实现应再发远端取消。
+
+## 4. 原始链接索引
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| API | https://help.aliyun.com/zh/model-studio/qwen-asr-api-reference | 否 |
+| 模型/音频规格 | https://help.aliyun.com/zh/model-studio/asr-model/ | 否 |
+| 临时上传 | https://help.aliyun.com/zh/model-studio/get-temporary-file-url | 否 |
+| 价格 | https://help.aliyun.com/zh/model-studio/model-pricing | 否 |
+| API Key | https://bailian.console.aliyun.com/?apiKey=1#/api-key | **是** |

package/docs/model-adaptation/Qwen3-ASR-Flash-Realtime/Qwen3-ASR-Flash-Realtime_/347/231/276/347/202/274.md

@@ -0,0 +1,35 @@
+# Qwen3-ASR-Flash-Realtime · 百炼
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-28 |
+| 能力 | 实时语音识别（WebSocket，VAD/Manual） |
+| 平台模型 ID | `qwen3-asr-flash-realtime`（稳定别名，官方当前等同 `qwen3-asr-flash-realtime-2025-10-27`） |
+| 地域 | 华北2（北京）、新加坡 |
+| 文档/价格 | 公开，无需登录 |
+
+## 1. 协议与结果
+
+`wss://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api-ws/v1/realtime?model=qwen3-asr-flash-realtime`，Bearer 鉴权。顺序：`session.created` → `session.update` → `input_audio_buffer.append` →（Manual 发 `commit`）→ `session.finish` → `session.finished` 后断开。
+
+中间文本是 `conversation.item.input_audio_transcription.text`，最终文本是 `.completed`，失败是 `.failed/error`。不发 `session.finish` 就直接断开会丢弃未完成 item；会话后不支持复用连接。
+
+## 2. 限制与价格
+
+- `pcm/opus`，8kHz/16kHz，单声道；时长无限制；单个 Base64 `audio` 最大 15 MiB。
+- 多语种及中文方言；支持情感识别，不支持热词和说话人分离。
+- 北京原价 0.00033 元/秒；官方列 36,000 秒/10 小时限时免费额度。
+
+## 3. 适配要点
+
+稳定别名与 2026-02-10 快照并列注册；不把官方当前指向的 2025-10-27 快照写死到请求构建器。该序列与 Fun-ASR 事件序列分开实现。
+
+## 4. 原始链接索引
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| 模型/音频规格 | https://help.aliyun.com/zh/model-studio/asr-model/ | 否 |
+| WebSocket 交互 | https://help.aliyun.com/zh/model-studio/qwen-asr-realtime-interaction-process | 否 |
+| 事件 | https://help.aliyun.com/zh/model-studio/qwen-asr-realtime-client-events ; https://help.aliyun.com/zh/model-studio/qwen-asr-realtime-server-events | 否 |
+| 价格 | https://help.aliyun.com/zh/model-studio/model-pricing | 否 |
+| API Key | https://bailian.console.aliyun.com/?apiKey=1#/api-key | **是** |

package/docs/model-adaptation/Qwen3-ASR-Flash-Realtime-2026-02-10/Qwen3-ASR-Flash-Realtime-2026-02-10_/347/231/276/347/202/274.md

@@ -0,0 +1,37 @@
+# Qwen3-ASR-Flash-Realtime-2026-02-10 · 百炼
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-08-28 |
+| 能力 | 实时语音识别（WebSocket，VAD/Manual） |
+| 平台模型 ID | `qwen3-asr-flash-realtime-2026-02-10`（最新快照） |
+| 地域 | 华北2（北京）、新加坡 |
+| 文档/价格 | 公开，无需登录 |
+
+## 1. 协议
+
+`wss://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api-ws/v1/realtime?model=qwen3-asr-flash-realtime-2026-02-10`，握手头 `Authorization: Bearer <API Key>`。
+
+连接后接收 `session.created`，首先发 `session.update`；用 `input_audio_buffer.append` 分块追加 Base64 音频。VAD 模式等服务端自动断句；Manual 模式发 `input_audio_buffer.commit`。结束必须发 `session.finish`，等 `session.finished` 后主动断开。
+
+中间文本：`conversation.item.input_audio_transcription.text`；最终文本：`.completed`；失败：`.failed` 或 `error`。该协议不支持会话后复用连接。
+
+## 2. 限制与价格
+
+- `pcm/opus`，8kHz/16kHz，单声道，时长无限制；单个 `append.audio` 最大 15 MiB，实时场景使用小块。
+- 多语种及中文方言；支持情感识别，不支持热词和说话人分离。
+- 北京原价 0.00033 元/秒；官方列 36,000 秒/10 小时限时免费额度。
+
+## 3. 适配要点
+
+与 Fun-ASR-Realtime 的 `run-task` 协议完全不同，不得仅换 `model` 复用消息序列。用户取消也需关闭本会话 socket，不得等待无限期的最终事件。
+
+## 4. 原始链接索引
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| 模型/音频规格 | https://help.aliyun.com/zh/model-studio/asr-model/ | 否 |
+| WebSocket 交互 | https://help.aliyun.com/zh/model-studio/qwen-asr-realtime-interaction-process | 否 |
+| 客户端/服务端事件 | https://help.aliyun.com/zh/model-studio/qwen-asr-realtime-client-events ; https://help.aliyun.com/zh/model-studio/qwen-asr-realtime-server-events | 否 |
+| 价格 | https://help.aliyun.com/zh/model-studio/model-pricing | 否 |
+| API Key | https://bailian.console.aliyun.com/?apiKey=1#/api-key | **是** |