@henjicc/ai-sdk 0.9.0 → 0.10.0

package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206//347/201/253/345/261/261/345/274/225/346/223/216.md

@@ -1,87 +1,131 @@
-# 火山引擎（Doubao / Ark 方舟）
-
-> 核对时间：2026-08-26。信息来源见文末「原始链接索引」，均无需登录（部分页面需要用浏览器打开，SPA 内容 curl 拿不到，见文档采集手册）。
-
-## 1. 摘要
-
-| 项目 | 取值 |
-|---|---|
-| `providerId`（项目内约定） | `volcengine` / `ark` |
-| 对应项目 `adapter` | `openai`（Chat Completions）；官方还提供 Responses API |
-| 接入优先级（本项目约定，见 [README 第三节](../README.md)） | 目录内三款模型已默认走 **Responses API**；Chat Completions 保留兼容，官方没有 Anthropic Messages API |
-| 鉴权 | `Authorization: Bearer $ARK_API_KEY` |
-| Base URL | `https://ark.cn-beijing.volces.com/api/v3`（区域相关，其余区域见控制台） |
-| 官方协议 | Chat Completions（`/chat/completions`）与 Responses API（`/responses`）**并行维护**，新模型同步支持两者 |
-
-## 2. 模型清单
-
-| 模型 ID | 简介 | 输入 → 输出 | 上下文 / 最大输入 | 最大思维链 / 最大输出 | RPM / TPM |
-|---|---|---|---|---|---|
-| `doubao-seed-evolving` | 面向 Agent/Coding 的持续升级模型，**Model ID 固定、版本自动滚动**，无需迁移即可拿到新能力 | 文本、图片、视频 → 文本 | 1024K / 1024K | 256K / 256K | 500 / 1,000,000 |
-| `doubao-seed-2-1-pro-260628` | Seed 2.1 高复杂度任务版本 | 文本、图片、视频 → 文本 | 256K / 256K | 256K / 256K | 500 / 1,000,000 |
-| `doubao-seed-2-1-turbo-260628` | Seed 2.1 规模化、成本更友好版本 | 文本、图片、视频 → 文本 | 256K / 256K | 256K / 256K | 500 / 1,000,000 |
-
-价格（元/百万 tokens，常规在线推理档）：
-
-| 模型 | 输入 | 缓存命中 | 缓存存储 | 输出 |
-|---|---|---|---|---|
-| `doubao-seed-evolving` | 6.00 | 1.20 | 0.017/小时 | 30.00 |
-| `doubao-seed-2-1-pro` | 6.00 | 1.20 | 0.017/小时 | 30.00 |
-| `doubao-seed-2-1-turbo` | 3.00 | 0.60 | 0.017/小时 | 15.00 |
-
-批量推理（Batch）：Pro 输入 3.00/输出 15.00，Turbo 输入 1.50/输出 7.50（均半价）。低延迟档 Turbo 价格与 Pro 常规档相同（6.00/1.20/30.00）——**低延迟不等于更贵的 Pro**，是 Turbo 的一个独立计价维度，选型时不要按模型名猜价格。
-
-`doubao-1-5-pro-32k-character-250715` **不支持** Responses API（官方原文标注的唯一例外），其余 250615 及之后版本的大语言模型默认都支持。
-
-## 3. 思考模式
-
-- 深度思考默认开启，用 `thinking` 参数控制开关。
-- `reasoning_effort` 支持 **7 档**：`none`/`minimal`/`low`/`medium`/`high`/`xhigh`/`max`，默认 `high`。（此前整理的资料只列了 4 档，遗漏了 `none`/`xhigh`/`max`。）
-- 思考内容默认只返回**摘要**（thinking summary）+ 加密原文，不返回原始思维链；多轮对话建议全量回传加密原文，服务端会按场景判断是否丢弃：
-  - Chat API：回传 `encrypted_content` 字段。
-  - Responses API：用 `previous_response_id` 引用上一轮响应即可，不需要手动回传思考内容。
-
-## 4. Chat API vs Responses API——字段级差异（接入 Responses 前必读）
-
-| 维度 | Chat API | Responses API |
-|---|---|---|
-| 输入 | `messages` 数组，无状态，每轮自己拼全部历史 | `input` 可以是字符串或数组；`instructions` 字段可在某一轮临时插入 system 提示 |
-| 多轮管理 | 手动维护 `messages` | 默认开启存储，`previous_response_id` 引用上一轮，服务端管理上下文 |
-| 结构化输出 | `response_format` | `text.format` |
-| 最大输出长度 | `max_completion_tokens` | `max_output_tokens` |
-| 工具定义 | `{"type":"function","function":{"name":...,"parameters":...}}`（嵌套） | `{"type":"function","name":...,"parameters":...}`（**扁平，`name`/`parameters` 提到外层**） |
-| 上下文缓存 | 隐式缓存（自动，不保证命中） | 隐式缓存 + **显式缓存**（`caching:{"type":"enabled"}`，ID 粒度更灵活） |
-
-**内置工具（联网搜索、图像处理、私域知识库搜索、云部署 MCP）只有 Responses API 能用，Chat API 完全不支持**——这是选择要不要接 Responses API 的最直接理由。
-
-## 5. 内置工具（均只在 Responses API 可用）
-
-| 工具 | `tools` 声明 | 备注 |
-|---|---|---|
-| 联网搜索 Web Search | `{"type":"web_search","max_keyword":2}` | 通过 Responses API 使用时**不推荐 `doubao-seed-1-6-flash`** |
-| 图像处理 Image Process | `{"type":"image_process","zoom":{"type":"enabled"},...}` | 需要额外 Header `ark-beta-image-process: true`，支持画点/画线/旋转/缩放/裁剪 |
-| 私域知识库搜索 Knowledge Search | `{"type":"knowledge_search","knowledge_resource_id":...}` | 需要额外 Header `ark-beta-knowledge-search: true`，仅支持旗舰版知识库 |
-| 云部署 MCP | `{"type":"mcp","server_label":...,"server_url":...}` | 对接 MCP MarketPlace，需要 Header `ark-beta-mcp: true` |
-
-这些工具都要求额外的 `default_headers`/`extra_headers` 才能生效，不是单纯在 `tools` 里声明就够——遗漏 Header 大概率是"请求成功但工具没触发"的静默失效，而不是报错。
-
-## 6. 图片理解精细度
-
-`detail` 参数：`low`（token [1,1280]，像素 [1764, 2257920]）/ `high`（固定 1280 token，默认值）/ `xhigh`（token [1280,5120]，像素 [2257920, 9031680]）。图片/视频/文档超过 10MB 建议用 Files API 先上传拿 File ID，不要直接塞 base64。
-
-## 7. 与「豆包搜索」的区别（避免混淆）
-
-火山引擎还有一个独立消费产品叫「豆包搜索」，是 **Agent Plan 套餐**（编程 IDE/Agent 场景）的联网搜索订阅服务，通过 Skill/MCP 接入 Claude Code、OpenCode 等三方工具，跟本文档说的 Responses API `web_search` 内置工具**不是同一套东西**——前者是终端用户在 IDE 里用的订阅制服务，后者是纯 API 调用参数。本项目走 API 集成，不涉及豆包搜索。
-
-## 原始链接索引（均无需登录；SPA 页面用浏览器打开，见采集手册）
-
-- [Doubao-Seed-Evolving 模型详情](https://docs.volcengine.com/docs/82379/2549861)
-- [模型列表](https://docs.volcengine.com/docs/82379/1330310)
-- [模型价格](https://docs.volcengine.com/docs/82379/1544106)
-- [使用 Responses API（基础差异对照）](https://docs.volcengine.com/docs/82379/1585128)
-- [Responses API 文本生成](https://docs.volcengine.com/docs/82379/1958520)
-- [Responses API 深度思考](https://docs.volcengine.com/docs/82379/1956279)
-- [Responses API 多模态理解](https://docs.volcengine.com/docs/82379/1958521)
-- [Responses API 结构化输出(beta)](https://docs.volcengine.com/docs/82379/1958523)
-- [工具调用（内置工具汇总）](https://docs.volcengine.com/docs/82379/1958524)
-- [豆包搜索（Agent Plan 订阅服务，仅供区分参考）](https://docs.volcengine.com/docs/82379/2301412)
+# 火山引擎（Doubao / Ark 方舟）
+
+> 核对时间：2026-11-07（模型清单与价格）；协议与内置工具部分 2026-08-26。信息来源见文末「原始链接索引」，均无需登录（部分页面需要用浏览器打开，SPA 内容 curl 拿不到，见文档采集手册）。
+
+## 1. 摘要
+
+| 项目 | 取值 |
+|---|---|
+| `providerId`（项目内约定） | `volcengine` / `ark` |
+| 对应项目 `adapter` | `openai`（Chat Completions）；官方还提供 Responses API |
+| 接入优先级（本项目约定，见 [README 第三节](../README.md)） | 豆包自研模型默认走 **Responses API**；托管的第三方模型走 Chat Completions；官方另有 Messages API，项目未接 |
+| 鉴权 | `Authorization: Bearer $ARK_API_KEY` |
+| Base URL | `https://ark.cn-beijing.volces.com/api/v3`（区域相关，其余区域见控制台） |
+| 官方协议 | Chat Completions（`/chat/completions`）与 Responses API（`/responses`）**并行维护**，新模型同步支持两者 |
+
+## 2. 模型清单
+
+2026-11-07 按方舟[模型列表](https://docs.volcengine.com/docs/ark/model-list?lang=zh)「文本生成能力」重新核对。方舟除豆包自研模型外，还上架了 DeepSeek、Kimi、GLM 的托管版本，Model ID 用短横线和快照日期（如 `kimi-k3-1-pro-261024`），与原厂写法不同；项目目录用别名把它们归到同一条能力记录。
+
+### 2.1 豆包自研
+
+| 模型 ID | 能力 | 上下文 / 最大输入 | 最大回答 / 最大思维链 | RPM / TPM |
+|---|---|---|---|---|
+| `doubao-seed-evolving` | 深度思考、多模态理解、GUI、工具、结构化输出；**Model ID 固定、版本自动滚动** | 1024K / 1024K | 256K / 256K | 500 / 1,000,000 |
+| `doubao-seed-2-1-pro-260915` | 同上 | 1024K / 1024K | 256K / 256K | 500 / 1,000,000 |
+| `doubao-seed-2-1-lite-260915` | 同上；另支持音频理解、决策评估（beta） | 1024K / 1024K | 256K / 256K | 30,000 / 5,000,000 |
+| `doubao-seed-2-1-turbo-260628` | 同上 | 256K / 256K | 256K / 256K | 500 / 1,000,000 |
+| `doubao-seed-2-1-pro-260628` | 同上（旧快照，仍可用） | 256K / 256K | 256K / 256K | 500 / 1,000,000 |
+| `doubao-seed-2-0-lite-260428`（LTS） | 同上；支持音频理解 | 256K / 224K | 128K / 128K | 30,000 / 5,000,000 |
+| `doubao-seed-2-0-mini-260428`（LTS） | 同上；支持音频理解 | 256K / 224K | 128K / 128K | 30,000 / 5,000,000 |
+| `doubao-seed-character-260628` | 角色扮演；深度思考、多模态理解、工具、结构化输出 | 128K / 96K | 32K / 128K | 30,000 / 5,000,000 |
+| `doubao-seed-translation-250915` | 翻译增强，不支持思考 | 4K / 1K | 3K / — | 5,000 / 500,000 |
+
+同一 2.1 Pro 的两个快照上下文不同（260915 为 1024K，260628 为 256K），项目目录按完整 Model ID 区分。
+即将下线（不进预设）：`doubao-seed-2-0-pro-260215`、`doubao-seed-2-0-lite-260215`、`doubao-seed-2-0-mini-260215`、`doubao-seed-2-0-code-preview-260215`；`doubao-seed-character-251128` 不支持深度思考。
+`doubao-seed-translation` 只有 1K 输入，面向逐段翻译，不作为对话或助手模型放进预设。
+
+### 2.2 方舟托管的第三方模型
+
+| 模型 ID | 能力 | 上下文 / 最大输入 | 最大回答 / 最大思维链 | RPM / TPM |
+|---|---|---|---|---|
+| `deepseek-v4-1-flash-261017` | 深度思考、多模态理解、工具、结构化输出 | 1024K / 1024K | 384K / 384K | 3,000 / 5,000,000 |
+| `deepseek-v4-1-flash-economy-261017` | 同上，经济版 | 1024K / 1024K | 384K / 384K | 3,000 / 5,000,000 |
+| `deepseek-v4-1-flash-260910` | 同上（旧快照） | 1024K / 1024K | 384K / 384K | 3,000 / 5,000,000 |
+| `deepseek-v4-pro-ga-260813` | 深度思考、工具、结构化输出（纯文本） | 1024K / 1024K | 384K / 128K | 500 / 1,000,000 |
+| `deepseek-v4-flash-ga-260731` | 深度思考、工具、结构化输出（纯文本） | 1024K / 1024K | 384K / 128K | 500 / 1,000,000 |
+| `kimi-k3-1-pro-261024` | 深度思考、多模态理解、工具、结构化输出 | 1024K / 1024K | 1024K / 128K | 3,000 / 3,000,000 |
+| `glm-5-3-flash-260828` | 深度思考、多模态理解、工具（列表未标结构化输出） | 1024K / 1024K | 128K / 128K | 500 / 1,000,000 |
+| `glm-5-2-260617` | 深度思考、工具（纯文本，列表未标结构化输出） | 1024K / 1024K | 128K / 128K | 500 / 1,000,000 |
+
+即将下线：`deepseek-v4-pro-260425`。
+
+### 2.3 价格（元/百万 tokens，常规在线推理）
+
+| 模型 | 条件（输入长度，千 token） | 输入 | 输入（音频） | 缓存命中 | 输出 |
+|---|---|---|---|---|---|
+| `doubao-seed-evolving` | [0, 1024] | 6.00 | — | 1.20 | 30.00 |
+| `doubao-seed-2.1-pro` | [0, 1024] | 6.00 | — | 1.20 | 30.00 |
+| `doubao-seed-2.1-lite` | [0, 1024] | 0.80 | 12.00 | 0.16 | 2.70 |
+| `doubao-seed-2.1-turbo` | [0, 256] | 3.00 | — | 0.60 | 15.00 |
+| `doubao-seed-2.0-lite` | [0,32] / (32,128] / (128,256] | 0.6 / 0.9 / 1.8 | 9.0 / 13.5 / 27.0 | 0.12 / 0.18 / 0.36 | 3.6 / 5.4 / 10.8 |
+| `doubao-seed-2.0-mini` | [0,32] / (32,128] / (128,256] | 0.2 / 0.4 / 0.8 | 3.0 / 6.0 / 12.0 | 0.04 / 0.08 / 0.16 | 2.0 / 4.0 / 8.0 |
+| `doubao-seed-character` | [0,32] / (32,128] | 0.80 / 1.20 | — | 0.16 / 0.16 | 2.00 / 6.00 |
+| `doubao-seed-translation` | — | 1.20 | — | — | 3.60 |
+| `glm-5.3-flash` | — | 0.80 | — | 0.23 | 2.80 |
+| `glm-5.2` | — | 8.00 | — | 2.00 | 28.00 |
+| `kimi-k3.1-pro` | — | 13.00 | — | 1.30 | 68.00 |
+| `deepseek-v4-1-flash` | 空闲 / 高峰 | 1.00 / 2.00 | — | 0.02 / 0.04 | 4.00 / 8.00 |
+| `deepseek-v4-1-flash` 经济版 | 空闲 / 高峰 | 0.80 / 1.60 | — | 0.016 / 0.032 | 3.20 / 6.40 |
+| `deepseek-v4-pro` 正式版 | — | 9.00 | — | 0.30 | 27.00 |
+| `deepseek-v4-flash` 正式版 | — | 3.00 | — | 0.10 | 9.00 |
+
+缓存存储均为 0.017 元/百万 token/小时。分段计费按单次请求输入长度落档，整次请求都按该档单价结算。DeepSeek V4.1 Flash 高峰时段为北京时间周一至周五 09:00–12:00、14:00–18:00，其余为空闲时段，以请求完成时间计。批量推理半价。
+
+### 2.4 协议
+
+方舟文本生成同时提供 Chat、Responses 与 Messages（Anthropic 兼容）三种接口；项目只用 Chat 与 Responses。官方说明“250615 及之后版本的大语言模型，如无特殊说明，默认支持 Responses API”，`doubao-1-5-pro-32k-character-250715` 是标注的例外。项目对豆包自研模型默认走 Responses；托管的第三方模型未逐个核实 Responses 字段兼容，预设保持 Chat。
+
+## 3. 思考模式
+
+- 深度思考默认开启，用 `thinking` 参数控制开关。
+- `reasoning_effort` 支持 **7 档**：`none`/`minimal`/`low`/`medium`/`high`/`xhigh`/`max`，默认 `high`。（此前整理的资料只列了 4 档，遗漏了 `none`/`xhigh`/`max`。）
+- 思考内容默认只返回**摘要**（thinking summary）+ 加密原文，不返回原始思维链；多轮对话建议全量回传加密原文，服务端会按场景判断是否丢弃：
+  - Chat API：回传 `encrypted_content` 字段。
+  - Responses API：用 `previous_response_id` 引用上一轮响应即可，不需要手动回传思考内容。
+
+## 4. Chat API vs Responses API——字段级差异（接入 Responses 前必读）
+
+| 维度 | Chat API | Responses API |
+|---|---|---|
+| 输入 | `messages` 数组，无状态，每轮自己拼全部历史 | `input` 可以是字符串或数组；`instructions` 字段可在某一轮临时插入 system 提示 |
+| 多轮管理 | 手动维护 `messages` | 默认开启存储，`previous_response_id` 引用上一轮，服务端管理上下文 |
+| 结构化输出 | `response_format` | `text.format` |
+| 最大输出长度 | `max_completion_tokens` | `max_output_tokens` |
+| 工具定义 | `{"type":"function","function":{"name":...,"parameters":...}}`（嵌套） | `{"type":"function","name":...,"parameters":...}`（**扁平，`name`/`parameters` 提到外层**） |
+| 上下文缓存 | 隐式缓存（自动，不保证命中） | 隐式缓存 + **显式缓存**（`caching:{"type":"enabled"}`，ID 粒度更灵活） |
+
+**内置工具（联网搜索、图像处理、私域知识库搜索、云部署 MCP）只有 Responses API 能用，Chat API 完全不支持**——这是选择要不要接 Responses API 的最直接理由。
+
+## 5. 内置工具（均只在 Responses API 可用）
+
+| 工具 | `tools` 声明 | 备注 |
+|---|---|---|
+| 联网搜索 Web Search | `{"type":"web_search","max_keyword":2}` | 通过 Responses API 使用时**不推荐 `doubao-seed-1-6-flash`** |
+| 图像处理 Image Process | `{"type":"image_process","zoom":{"type":"enabled"},...}` | 需要额外 Header `ark-beta-image-process: true`，支持画点/画线/旋转/缩放/裁剪 |
+| 私域知识库搜索 Knowledge Search | `{"type":"knowledge_search","knowledge_resource_id":...}` | 需要额外 Header `ark-beta-knowledge-search: true`，仅支持旗舰版知识库 |
+| 云部署 MCP | `{"type":"mcp","server_label":...,"server_url":...}` | 对接 MCP MarketPlace，需要 Header `ark-beta-mcp: true` |
+
+这些工具都要求额外的 `default_headers`/`extra_headers` 才能生效，不是单纯在 `tools` 里声明就够——遗漏 Header 大概率是"请求成功但工具没触发"的静默失效，而不是报错。
+
+## 6. 图片理解精细度
+
+`detail` 参数：`low`（token [1,1280]，像素 [1764, 2257920]）/ `high`（固定 1280 token，默认值）/ `xhigh`（token [1280,5120]，像素 [2257920, 9031680]）。图片/视频/文档超过 10MB 建议用 Files API 先上传拿 File ID，不要直接塞 base64。
+
+## 7. 与「豆包搜索」的区别（避免混淆）
+
+火山引擎还有一个独立消费产品叫「豆包搜索」，是 **Agent Plan 套餐**（编程 IDE/Agent 场景）的联网搜索订阅服务，通过 Skill/MCP 接入 Claude Code、OpenCode 等三方工具，跟本文档说的 Responses API `web_search` 内置工具**不是同一套东西**——前者是终端用户在 IDE 里用的订阅制服务，后者是纯 API 调用参数。本项目走 API 集成，不涉及豆包搜索。
+
+## 原始链接索引（均无需登录；SPA 页面用浏览器打开，见采集手册）
+
+- [Doubao-Seed-Evolving 模型详情](https://docs.volcengine.com/docs/82379/2549861)
+- [模型列表](https://docs.volcengine.com/docs/82379/1330310)（现跳转到 [docs/ark/model-list](https://docs.volcengine.com/docs/ark/model-list?lang=zh)，2026-11-07 核对）
+- [模型价格](https://docs.volcengine.com/docs/82379/1544106)（2026-11-07 核对）
+- [Responses API 迁移说明与支持模型](https://docs.volcengine.com/docs/ark/responses-api-migration?lang=zh)
+- [使用 Responses API（基础差异对照）](https://docs.volcengine.com/docs/82379/1585128)
+- [Responses API 文本生成](https://docs.volcengine.com/docs/82379/1958520)
+- [Responses API 深度思考](https://docs.volcengine.com/docs/82379/1956279)
+- [Responses API 多模态理解](https://docs.volcengine.com/docs/82379/1958521)
+- [Responses API 结构化输出(beta)](https://docs.volcengine.com/docs/82379/1958523)
+- [工具调用（内置工具汇总）](https://docs.volcengine.com/docs/82379/1958524)
+- [豆包搜索（Agent Plan 订阅服务，仅供区分参考）](https://docs.volcengine.com/docs/82379/2301412)

package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206//347/231/276/347/202/274Qwen.md

@@ -1,84 +1,112 @@
-# 阿里云百炼 / Qwen
-
-> 核对时间：2026-08-26。信息来源见文末「原始链接索引」。**控制台模型详情页（`bailian.console.aliyun.com`）需要登录**，实测自动化浏览器访问会被拦截（`请求失败，请检查网络设置`）；本文档内容全部来自 `help.aliyun.com` 的公开文档页，未登录也能完整核对协议、模型清单与价格。仅当需要交互式"体验中心"截图或账号级用量数据时才必须登录控制台。
-
-## 1. 摘要
-
-| 项目 | 取值 |
-|---|---|
-| `providerId`（项目内约定） | `bailian` / `dashscope` |
-| 对应项目 `adapter` | `openai`（Chat Completions）；官方也提供 Responses API |
-| 接入优先级（本项目约定，见 [README 第三节](../README.md)） | Qwen3.8-Max 已默认走 **Responses API**；Chat Completions 保留兼容，官方没有 Anthropic Messages API |
-| 鉴权 | `Authorization: Bearer $DASHSCOPE_API_KEY` |
-| Base URL | `https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1`（**地域相关，`{WorkspaceId}` 和区域后缀需要从控制台"查看代码"复制当前值，不要硬编码**） |
-| 官方协议 | OpenAI Chat Completions（`/chat/completions`）+ OpenAI Responses API（`/responses`），同一 Base URL 下两个路径 |
-
-## 2. 模型：`qwen3.8-max`
-
-千问最新旗舰 MoE 模型，强化编程、办公、原生视觉理解、超长文档与长视频能力。
-
-**关键适配陷阱**：`qwen3.8-max` 必须使用**多模态接口**格式发送消息，不能用给纯文本模型（如 `qwen-plus`）准备的简单文本接口——官方原文警告"直接替换模型会导致 `url error` 错误"。也就是说即便请求内容是纯文字对话，`qwen3.8-max` 的 `content` 字段也要按多模态消息数组的形式组织（`[{"type":"text","text":"..."}]`），不能直接传字符串。这是从"模型能力标注含图片/视频"这句话本身看不出来的隐藏约束，写 `request.builder()` 时必须按多模态 schema 走。
-
-同样要求多模态接口的还有：`qwen3.8-27b`、`qwen3.7-max-2026-06-08`、Qwen3.6/Qwen3.5 系列；仅需纯文本接口的是：`qwen3.8-2.4t-a95b`、`qwen3.7-max`、`qwen3.7-max-2026-05-20`、`qwen3.6-max-preview`。两类接口不能混用模型 ID。
-
-### 价格（元/百万 tokens，`0 < Token ≤ 1M`，服务部署范围"全球"）
-
-| 模型 ID | 输入 | 输出（思维链+回答） | 免费额度 |
-|---|---|---|---|
-| `qwen3.8-max` | 12 | 36 | 100 万 Token（有效期 90 天） |
-| `qwen3.8-max-prime`（优速模式 Prime） | 24 | 72 | 无免费额度 |
-
-`qwen3.8-max-prime` 是此前资料遗漏的一个变体——"优速模式"，价格是标准版的整整 2 倍，用于对延迟更敏感的场景，属于同一发布线下的独立计价档位，接入时应作为一个可选的产品级参数（渠道/模式）而不是隐藏细节。
-
-国际（`国际`）与欧盟区域价格更高（`qwen3.8-max` 国际区 14.988/44.965 元），实际扣费以当前请求命中的区域为准；Batch 调用半价，上下文缓存命中享折扣（具体折扣比例见 [上下文缓存文档](https://help.aliyun.com/document_detail/2862577.html)）。
-
-## 3. Responses API 接入示例
-
-```python
-client = OpenAI(api_key=..., base_url="https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1")
-response = client.responses.create(model="qwen3.8-max", input="简要介绍下你能做什么？")
-```
-
-- 返回结构里 `output` 数组包含 `reasoning`（仅思考模式开启时出现）和 `message`。
-- **已知限制**：Responses API 路径**不支持** `enable_source`/`enable_citation`/`citation_format` 参数，不会在回复正文里自动插入 `[1]` 角标引用——如果产品需要角标标注，只能退回传统 DashScope 原生调用方式，不能靠 Responses API 实现。
-
-## 4. 思考模式
-
-用 `extra_body={"enable_thinking": true}`（Chat Completions/Responses 均适用）控制是否开启深度思考；官方没有像 GLM/Kimi 那样给出离散的 `reasoning_effort` 档位字符串，是布尔开关而非强度分级。
-
-## 5. 联网搜索与内置工具
-
-Responses API 下可以在 `tools` 数组里组合声明三个内置工具，模型自主决定调不调用：
-
-```python
-response = client.responses.create(
-    model="qwen3.8-max",
-    input="杭州天气",
-    tools=[
-        {"type": "web_search"},
-        {"type": "web_extractor"},
-        {"type": "code_interpreter"},
-    ],
-    extra_body={"enable_thinking": True},
-)
-```
-
-- `web_search`：联网搜索，价格 4 元/1,000 次。
-- `web_extractor`：网页正文抓取，官方页面标注限时免费。
-- `code_interpreter`：代码解释器，官方页面标注限时免费。
-- 搜索来源在响应 `output` 数组里 `type=web_search_call` 的元素、其 `action.sources` 字段里，不在正文文本中自动标注引用。
-- **Chat Completions 路径的等价用法更简单**：直接传 `enable_search: true`（布尔值），不需要声明完整的 `tools` 数组，但拿不到 `web_extractor`/`code_interpreter` 这类独立工具，只有联网搜索一项。两条路径的联网搜索能力不完全对等，接入时要按实际选的协议决定暴露哪种开关。
-
-## 6. 与其它供应商在百炼上共存（了解即可，不改变本文档定位）
-
-百炼控制台除了阿里自有的 Qwen 系列，还以"三方直供"名义上架了 Kimi K3、智谱 GLM-5.3、MiniMax-M3、`mimo-v2.5-pro` 等——即这几家供应商也可以通过百炼这个统一入口调用。本项目的供应商划分以官方原生 API 为准（各自单独一份文档），百炼上的"三方直供"版本只是同一模型的另一个接入口，不单独维护文档，只在这里作为背景记录。
-
-## 原始链接索引
-
-- [模型概览（含所有可用模型清单）](https://help.aliyun.com/zh/model-studio/models) — 无需登录
-- [文本生成（含 Chat Completions/Responses 双协议代码示例、多模态接口区分表）](https://help.aliyun.com/zh/model-studio/text-generation) — 无需登录
-- [联网搜索工具](https://help.aliyun.com/zh/model-studio/web-search) — 无需登录
-- [模型价格](https://help.aliyun.com/zh/model-studio/model-pricing) — 无需登录
-- [Qwen 使用指南](https://help.aliyun.com/zh/model-studio/user-guide/qwen) — 无需登录
-- [OpenAI 兼容-Responses（完整迁移指南）](https://help.aliyun.com/document_detail/3016539.html) — 无需登录
-- 百炼控制台模型详情页（`bailian.console.aliyun.com/.../model-market/detail/qwen3.8-max`）—— **需要登录**，自动化访问被拦截；需要交互式体验或账号级信息时再手动登录查看
+# 阿里云百炼 / Qwen
+
+> 核对时间：2026-11-07（第 2b 节模型清单、价格与 Responses 支持范围）；其余部分 2026-08-26。信息来源见文末「原始链接索引」。**控制台模型详情页（`bailian.console.aliyun.com`）需要登录**，实测自动化浏览器访问会被拦截（`请求失败，请检查网络设置`）；本文档内容全部来自 `help.aliyun.com` 的公开文档页，未登录也能完整核对协议、模型清单与价格。仅当需要交互式"体验中心"截图或账号级用量数据时才必须登录控制台。
+
+## 1. 摘要
+
+| 项目 | 取值 |
+|---|---|
+| `providerId`（项目内约定） | `bailian` / `dashscope` |
+| 对应项目 `adapter` | `openai`（Chat Completions）；官方也提供 Responses API |
+| 接入优先级（本项目约定，见 [README 第三节](../README.md)） | 官方列入 Responses 支持清单的模型默认走 **Responses API**（见第 2b 节）；其余走 Chat Completions；官方没有 Anthropic Messages API |
+| 鉴权 | `Authorization: Bearer $DASHSCOPE_API_KEY` |
+| Base URL | `https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1`（**地域相关，`{WorkspaceId}` 和区域后缀需要从控制台"查看代码"复制当前值，不要硬编码**） |
+| 官方协议 | OpenAI Chat Completions（`/chat/completions`）+ OpenAI Responses API（`/responses`），同一 Base URL 下两个路径 |
+
+## 2. 模型：`qwen3.8-max`
+
+千问最新旗舰 MoE 模型，强化编程、办公、原生视觉理解、超长文档与长视频能力。
+
+**关键适配陷阱**：`qwen3.8-max` 必须使用**多模态接口**格式发送消息，不能用给纯文本模型（如 `qwen-plus`）准备的简单文本接口——官方原文警告"直接替换模型会导致 `url error` 错误"。也就是说即便请求内容是纯文字对话，`qwen3.8-max` 的 `content` 字段也要按多模态消息数组的形式组织（`[{"type":"text","text":"..."}]`），不能直接传字符串。这是从"模型能力标注含图片/视频"这句话本身看不出来的隐藏约束，写 `request.builder()` 时必须按多模态 schema 走。
+
+同样要求多模态接口的还有：`qwen3.8-27b`、`qwen3.7-max-2026-06-08`、Qwen3.6/Qwen3.5 系列；仅需纯文本接口的是：`qwen3.8-2.4t-a95b`、`qwen3.7-max`、`qwen3.7-max-2026-05-20`、`qwen3.6-max-preview`。两类接口不能混用模型 ID。
+
+### 价格（元/百万 tokens，`0 < Token ≤ 1M`，服务部署范围"全球"）
+
+| 模型 ID | 输入 | 输出（思维链+回答） | 免费额度 |
+|---|---|---|---|
+| `qwen3.8-max` | 12 | 36 | 100 万 Token（有效期 90 天） |
+| `qwen3.8-max-prime`（优速模式 Prime） | 24 | 72 | 无免费额度 |
+
+`qwen3.8-max-prime` 是此前资料遗漏的一个变体——"优速模式"，价格是标准版的整整 2 倍，用于对延迟更敏感的场景，属于同一发布线下的独立计价档位，接入时应作为一个可选的产品级参数（渠道/模式）而不是隐藏细节。
+
+国际（`国际`）与欧盟区域价格更高（`qwen3.8-max` 国际区 14.988/44.965 元），实际扣费以当前请求命中的区域为准；Batch 调用半价，上下文缓存命中享折扣（具体折扣比例见 [上下文缓存文档](https://help.aliyun.com/document_detail/2862577.html)）。
+
+## 2b. 其他文本模型（2026-11-07 核对）
+
+按[文本生成模型选型](https://help.aliyun.com/zh/model-studio/text-generation-model)与[模型调用计费](https://help.aliyun.com/zh/model-studio/model-pricing)（华北2 北京）核对。官方推荐：默认 `qwen3.7-plus`，效果优先 `qwen3.8-max`，成本优先 `qwen3.8-flash`；Plus、Max、Flash 都接收文本、图像和视频，输出文本。
+
+| 模型 ID | 上下文 / 最大输出 | 思考 | 工具 | 内置工具 | 结构化输出 | 输入 / 输出（元/百万 tokens） |
+|---|---|---|---|---|---|---|
+| `qwen3.8-max`（含快照 `qwen3.8-max-0902`） | 1M / 128K | 思考与非思考 | 支持 | 支持 | 支持 | 12 / 36 |
+| `qwen3.8-flash` | 1M / 128K | 思考与非思考 | 支持 | 支持 | 支持 | 0.8 / 2.7 |
+| `qwen3.7-plus` | 1M / 128K | 思考与非思考 | 支持 | 支持 | 支持 | ≤256K：2 / 8；256K–1M：6 / 24（页面标注限时 8 折，表内为原价） |
+| `deepseek-v4.1-flash`（含 `-1017`） | 1M / 未列 | 支持 | 支持 | 支持 | 支持 | 忙时 2 / 8，闲时 1 / 4 |
+| `deepseek-v4-pro-0813` | 1M / 未列 | 支持 | 支持 | — | — | 忙时 9 / 27，闲时 4.5 / 13.5 |
+| `kimi-k3.1-pro` | 1M / 未列 | 思考与非思考（默认开） | 支持 | 支持（仅 Responses） | JSON Mode | 13 / 68（缓存命中输入 1.3） |
+| `kimi-k3` | 1M / 未列 | 仅思考 | 支持 | 不支持 | 支持 | 20 / 100 |
+| `glm-5.3` | 1M / 未列 | 思考与非思考 | 支持 | 不支持 | 支持 | 8 / 28 |
+| `MiniMax/MiniMax-M3.1-Flash` | 1M / 未列 | 仅思考 | 支持 | 不支持 | 不支持 | 1 / 4 |
+| `xiaomi/mimo-v2.6-pro-ultraspeed` | 1M / 未列 | 支持 | 支持 | 不支持 | 支持 | 30 / 60 |
+| `stepfun/step-5-preview` | 1M / 未列 | 支持 | 支持 | 不支持 | 支持 | 7 / 20 |
+
+图像与视频参数（Max / Flash / Plus 相同）：单图最大 16M 像素、最多 2048 张图；视频最长 2 小时、最大 2GB、最多 64 段。
+
+忙时为北京时间 08:00–22:00。Batch 调用半价；上下文缓存只给输入打折，二者不能同时生效。三方模型在华北2以外地域没有免费额度。
+
+**Responses 支持的模型**（[OpenAI 兼容-Responses](https://help.aliyun.com/zh/model-studio/compatibility-with-openai-responses-api)，2026-11-07）：Qwen 3.5–3.8 各档（含 `qwen3.8-flash`、`qwen3.7-plus`），以及 `deepseek-v4.1-flash`、`deepseek-v4.1-flash-1017`、`deepseek-v4-pro`、`deepseek-v4-pro-0813`、`deepseek-v4-flash-0731`、`glm-5.3`、`glm-5.2`、`kimi-k3`。列表里没有 `kimi-k3.1-pro`、`MiniMax-M3.1-Flash`、`mimo-v2.6-pro-ultraspeed`、`step-5-preview`，项目对它们走 Chat。Responses 下 `reasoning.effort` 优先于 `enable_thinking`。
+
+三方直供模型的 API Model ID 带厂商前缀（计费页“模型 ID”列，如 `MiniMax/MiniMax-M3.1-Flash`、`kimi/kimi-k3`），选型页只写短名；`kimi-k3` 与 `kimi/kimi-k3` 是百炼代运营与月之暗面直供两个渠道，同价。带日期后缀的四位快照（`-0902`、`-1017`、`-0813`）不在目录的自动去快照规则内，项目目录用别名登记。`qwen3.8-omni-flash` 面向音视频输入，需要按 Omni 调用指南走流式输出，暂不进预设。
+
+## 3. Responses API 接入示例
+
+```python
+client = OpenAI(api_key=..., base_url="https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1")
+response = client.responses.create(model="qwen3.8-max", input="简要介绍下你能做什么？")
+```
+
+- 返回结构里 `output` 数组包含 `reasoning`（仅思考模式开启时出现）和 `message`。
+- **已知限制**：Responses API 路径**不支持** `enable_source`/`enable_citation`/`citation_format` 参数，不会在回复正文里自动插入 `[1]` 角标引用——如果产品需要角标标注，只能退回传统 DashScope 原生调用方式，不能靠 Responses API 实现。
+
+## 4. 思考模式
+
+用 `extra_body={"enable_thinking": true}`（Chat Completions/Responses 均适用）控制是否开启深度思考；官方没有像 GLM/Kimi 那样给出离散的 `reasoning_effort` 档位字符串，是布尔开关而非强度分级。
+
+## 5. 联网搜索与内置工具
+
+Responses API 下可以在 `tools` 数组里组合声明三个内置工具，模型自主决定调不调用：
+
+```python
+response = client.responses.create(
+    model="qwen3.8-max",
+    input="杭州天气",
+    tools=[
+        {"type": "web_search"},
+        {"type": "web_extractor"},
+        {"type": "code_interpreter"},
+    ],
+    extra_body={"enable_thinking": True},
+)
+```
+
+- `web_search`：联网搜索，价格 4 元/1,000 次。
+- `web_extractor`：网页正文抓取，官方页面标注限时免费。
+- `code_interpreter`：代码解释器，官方页面标注限时免费。
+- 搜索来源在响应 `output` 数组里 `type=web_search_call` 的元素、其 `action.sources` 字段里，不在正文文本中自动标注引用。
+- **Chat Completions 路径的等价用法更简单**：直接传 `enable_search: true`（布尔值），不需要声明完整的 `tools` 数组，但拿不到 `web_extractor`/`code_interpreter` 这类独立工具，只有联网搜索一项。两条路径的联网搜索能力不完全对等，接入时要按实际选的协议决定暴露哪种开关。
+
+## 6. 与其它供应商在百炼上共存（了解即可，不改变本文档定位）
+
+百炼控制台除了阿里自有的 Qwen 系列，还以"三方直供"名义上架了 Kimi K3、智谱 GLM-5.3、MiniMax-M3、`mimo-v2.5-pro` 等——即这几家供应商也可以通过百炼这个统一入口调用。本项目的供应商划分以官方原生 API 为准（各自单独一份文档），百炼上的"三方直供"版本只是同一模型的另一个接入口，不单独维护文档，只在这里作为背景记录。
+
+## 原始链接索引
+
+- [模型概览（含所有可用模型清单）](https://help.aliyun.com/zh/model-studio/models) — 无需登录
+- [文本生成（含 Chat Completions/Responses 双协议代码示例、多模态接口区分表）](https://help.aliyun.com/zh/model-studio/text-generation) — 无需登录
+- [联网搜索工具](https://help.aliyun.com/zh/model-studio/web-search) — 无需登录
+- [模型价格](https://help.aliyun.com/zh/model-studio/model-pricing) — 无需登录（2026-11-07 核对）
+- [文本生成模型选型](https://help.aliyun.com/zh/model-studio/text-generation-model) — 无需登录（2026-11-07 核对）
+- [OpenAI 兼容-Responses 支持模型](https://help.aliyun.com/zh/model-studio/compatibility-with-openai-responses-api) — 无需登录（2026-11-07 核对）
+- [Qwen 使用指南](https://help.aliyun.com/zh/model-studio/user-guide/qwen) — 无需登录
+- [OpenAI 兼容-Responses（完整迁移指南）](https://help.aliyun.com/document_detail/3016539.html) — 无需登录
+- 百炼控制台模型详情页（`bailian.console.aliyun.com/.../model-market/detail/qwen3.8-max`）—— **需要登录**，自动化访问被拦截；需要交互式体验或账号级信息时再手动登录查看