@henjicc/ai-sdk 0.8.0 → 0.10.0

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

@@ -1,40 +1,40 @@
-# Qwen-MT-Plus · 百炼
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-09-24 |
-| 能力 | 文本翻译（非流式 / 累积流式） |
-| 平台模型 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/单测证据，尚无真实付费请求证据。
-- 2026-09-24 复核结束语义、合法空帧、重复最终快照、用量、错误、截断及取消；详见 [三模型共享事件契约与回归矩阵](../Qwen-MT-Flash/Qwen-MT-Flash_百炼.md#三模型共享事件契约与回归矩阵2026-09-24)。Plus 仍按累积快照计算变化；只有 `stop` 才交付完整 item，`length` 明确报告截断。
-
-## 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-Plus · 百炼
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-09-24 |
+| 能力 | 文本翻译（非流式 / 累积流式） |
+| 平台模型 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/单测证据，尚无真实付费请求证据。
+- 2026-09-24 复核结束语义、合法空帧、重复最终快照、用量、错误、截断及取消；详见 [三模型共享事件契约与回归矩阵](../Qwen-MT-Flash/Qwen-MT-Flash_百炼.md#三模型共享事件契约与回归矩阵2026-09-24)。Plus 仍按累积快照计算变化；只有 `stop` 才交付完整 item，`length` 明确报告截断。
+
+## 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

@@ -1,44 +1,44 @@
-# Qwen3-ASR-Flash · 百炼
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-09-21 |
-| 能力 | 短音频同步识别（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 | **是** |
-
-## 2026-09-21 文件传输边界复核
-
-官方 API 的 Base64 输入说明明确要求编码后不超过 10 MB。SDK 按十进制保守折算原始音频最大 7,500,000 字节（4 × ceil(n/3) ≤ 10,000,000），仍受 5 分钟限制；不能把原始字节的 10 MiB 当作 Base64 上限。
+# Qwen3-ASR-Flash · 百炼
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-09-21 |
+| 能力 | 短音频同步识别（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 | **是** |
+
+## 2026-09-21 文件传输边界复核
+
+官方 API 的 Base64 输入说明明确要求编码后不超过 10 MB。SDK 按十进制保守折算原始音频最大 7,500,000 字节（4 × ceil(n/3) ≤ 10,000,000），仍受 5 分钟限制；不能把原始字节的 10 MiB 当作 Base64 上限。

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

@@ -1,37 +1,37 @@
-# Qwen3-ASR-Flash-2026-02-10 · 百炼
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-09-21 |
-| 能力 | 短音频同步识别（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 | **是** |
-
-## 2026-09-21 文件传输边界复核
-
-官方 API 的 Base64 输入说明要求编码后不超过 10 MB。SDK 原始音频上限取 7,500,000 字节，仍受 5 分钟限制；与 qwen3-asr-flash 共享分块 JSON 路径。
+# Qwen3-ASR-Flash-2026-02-10 · 百炼
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-09-21 |
+| 能力 | 短音频同步识别（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 | **是** |
+
+## 2026-09-21 文件传输边界复核
+
+官方 API 的 Base64 输入说明要求编码后不超过 10 MB。SDK 原始音频上限取 7,500,000 字节，仍受 5 分钟限制；与 qwen3-asr-flash 共享分块 JSON 路径。

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

@@ -1,45 +1,45 @@
-# Qwen3-ASR-Flash-Filetrans · 百炼
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-09-21 |
-| 能力 | 长音频/录音文件异步识别 |
-| 平台模型 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 | **是** |
-
-## 2026-09-21 文件传输边界复核
-
-本地文件先原生直传临时 OSS，SDK media-ref 不走 media 通道。临时服务限制 1 GB，实际上限取 min(1,000,000,000, floor(max_file_size_mb × 1,000,000))；模型自身仍受 12 小时 / 2 GB 约束。
+# Qwen3-ASR-Flash-Filetrans · 百炼
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-09-21 |
+| 能力 | 长音频/录音文件异步识别 |
+| 平台模型 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 | **是** |
+
+## 2026-09-21 文件传输边界复核
+
+本地文件先原生直传临时 OSS，SDK media-ref 不走 media 通道。临时服务限制 1 GB，实际上限取 min(1,000,000,000, floor(max_file_size_mb × 1,000,000))；模型自身仍受 12 小时 / 2 GB 约束。

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

@@ -1,58 +1,58 @@
-# Qwen3-ASR-Flash-Realtime · 百炼
-
-| 项目 | 内容 |
-|---|---|
-| 最后更新 | 2026-09-24 |
-| 能力 | 实时语音识别（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. 服务端事件矩阵（稳定别名与 2026-02-10 快照共用）
-
-2026-09-24 核对官方服务端事件页，字段表构造样本见 `tests/fixtures/bailian/asr-realtime-qwen.json`。ID 和文本均为固定占位；删字段、改类型为测试中的 synthetic-negative，不代表真实供应商响应。
-
-| 事件 | 前置阶段与字段语义 | 迁移 / 输出 | 结束与资源 |
-|---|---|---|---|
-| `session.created` | opening；服务端默认 session，可含 null 配置 | 发送 update，等待 ready；不输出文字 | 继续 |
-| `session.updated` | opening；update 成功确认 | active，通知 started | 继续 |
-| `input_audio_buffer.speech_started` | VAD 检测语音；item_id 字符串、audio_start_ms 非负整数 | 已知状态通知，无文本 | 继续 |
-| `input_audio_buffer.speech_stopped` | VAD 停止语音；item_id 字符串、audio_end_ms 非负整数 | 已知状态通知，不当作 final | 继续 |
-| `input_audio_buffer.committed` | 音频提交确认；item_id 字符串 | 已知通知，不代替识别结果 | 继续 |
-| `conversation.item.created` | item 含 input_audio，transcript 固定为 null | 已知通知；item.status=completed 不等于识别完成 | 继续 |
-| `conversation.item.input_audio_transcription.text` | active/finishing；text/stash 均为字符串，任一可为空 | 原样 text + stash 作为 partial，不能分别 trim 破坏单词边界 | 继续 |
-| `conversation.item.input_audio_transcription.completed` | active/finishing；transcript 字符串 | final；不以未定义的 text 字段替代缺失 transcript | 句终态，仍等待会话结束 |
-| `conversation.item.input_audio_transcription.failed` | 某 item 识别失败；error.code/message | provider_task_failed，保留 code，不默认暴露完整 message | 失败并释放 |
-| `error` | 任一阶段；服务端或输入错误 | 同上，不能作为空事件忽略 | 失败并释放 |
-| `session.finished` | 仅客户端 finish 后；本事件无需 transcript | finishing → finished；使用累计 final，无有效 final 则 invalid_response | 主动断开，不复用 |
-| 有名未知事件 | 官方未定义扩展语义 | unknown 警告，不生成完成或文本 | 等待已有协议终态 |
-| 缺失 type / 错类型 / 无效必要结果字段 | 不能判定合法事件 | invalid_response，包含实际 model/protocol/阶段 | 失败并释放 |
-| 提前断开 / 取消 | 任一未完成阶段；无协议恢复事件 | 断连错误或取消，不当正常完成 | 关闭连接 |
-
-官方展示了 text 空而 stash 非空、以及相反的中间状态，未提供两者同时为空的有效结果示例；本次不据推测放宽该边界。现有 SDK 对有效 final 的要求仍是非空 transcript。状态通知不能掩盖缺失必要状态字段；不把所有未知扩展视为错误。错误诊断仅包含模型、协议、阶段、事件类型与供应商代码，不包含密钥、音频和完整识别/错误正文。
-
-## 5. 原始链接索引
-
-| 信息 | 链接 | 登录 |
-|---|---|---|
-| 模型/音频规格 | 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 | **是** |
+# Qwen3-ASR-Flash-Realtime · 百炼
+
+| 项目 | 内容 |
+|---|---|
+| 最后更新 | 2026-09-24 |
+| 能力 | 实时语音识别（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. 服务端事件矩阵（稳定别名与 2026-02-10 快照共用）
+
+2026-09-24 核对官方服务端事件页，字段表构造样本见 `tests/fixtures/bailian/asr-realtime-qwen.json`。ID 和文本均为固定占位；删字段、改类型为测试中的 synthetic-negative，不代表真实供应商响应。
+
+| 事件 | 前置阶段与字段语义 | 迁移 / 输出 | 结束与资源 |
+|---|---|---|---|
+| `session.created` | opening；服务端默认 session，可含 null 配置 | 发送 update，等待 ready；不输出文字 | 继续 |
+| `session.updated` | opening；update 成功确认 | active，通知 started | 继续 |
+| `input_audio_buffer.speech_started` | VAD 检测语音；item_id 字符串、audio_start_ms 非负整数 | 已知状态通知，无文本 | 继续 |
+| `input_audio_buffer.speech_stopped` | VAD 停止语音；item_id 字符串、audio_end_ms 非负整数 | 已知状态通知，不当作 final | 继续 |
+| `input_audio_buffer.committed` | 音频提交确认；item_id 字符串 | 已知通知，不代替识别结果 | 继续 |
+| `conversation.item.created` | item 含 input_audio，transcript 固定为 null | 已知通知；item.status=completed 不等于识别完成 | 继续 |
+| `conversation.item.input_audio_transcription.text` | active/finishing；text/stash 均为字符串，任一可为空 | 原样 text + stash 作为 partial，不能分别 trim 破坏单词边界 | 继续 |
+| `conversation.item.input_audio_transcription.completed` | active/finishing；transcript 字符串 | final；不以未定义的 text 字段替代缺失 transcript | 句终态，仍等待会话结束 |
+| `conversation.item.input_audio_transcription.failed` | 某 item 识别失败；error.code/message | provider_task_failed，保留 code，不默认暴露完整 message | 失败并释放 |
+| `error` | 任一阶段；服务端或输入错误 | 同上，不能作为空事件忽略 | 失败并释放 |
+| `session.finished` | 仅客户端 finish 后；本事件无需 transcript | finishing → finished；使用累计 final，无有效 final 则 invalid_response | 主动断开，不复用 |
+| 有名未知事件 | 官方未定义扩展语义 | unknown 警告，不生成完成或文本 | 等待已有协议终态 |
+| 缺失 type / 错类型 / 无效必要结果字段 | 不能判定合法事件 | invalid_response，包含实际 model/protocol/阶段 | 失败并释放 |
+| 提前断开 / 取消 | 任一未完成阶段；无协议恢复事件 | 断连错误或取消，不当正常完成 | 关闭连接 |
+
+官方展示了 text 空而 stash 非空、以及相反的中间状态，未提供两者同时为空的有效结果示例；本次不据推测放宽该边界。现有 SDK 对有效 final 的要求仍是非空 transcript。状态通知不能掩盖缺失必要状态字段；不把所有未知扩展视为错误。错误诊断仅包含模型、协议、阶段、事件类型与供应商代码，不包含密钥、音频和完整识别/错误正文。
+
+## 5. 原始链接索引
+
+| 信息 | 链接 | 登录 |
+|---|---|---|
+| 模型/音频规格 | 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

@@ -1,37 +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 | **是** |
+# 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 | **是** |