@henjicc/ai-sdk 0.8.0 → 0.10.0

package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206/Kimi.md

@@ -1,76 +1,94 @@
-# Kimi（Moonshot）
-
-> 核对时间：2026-08-26。信息来源见文末「原始链接索引」，均无需登录。
-
-## 1. 摘要
-
-| 项目 | 取值 |
-|---|---|
-| `providerId`（项目内约定） | `kimi` / `moonshot` |
-| 对应项目 `adapter` | `openai`（Chat Completions 兼容） |
-| 接入优先级（本项目约定，见 [README 第三节](../README.md)） | 官方**没有** Responses API 也**没有** Anthropic Messages API，Chat Completions 是唯一路径，已实现，无需再排优先级 |
-| 鉴权 | `Authorization: Bearer $MOONSHOT_API_KEY` |
-| Base URL | `https://api.moonshot.cn/v1`（文档站已迁移到 `platform.kimi.com`，但**接口域名仍是 moonshot.cn**，不要混淆两个域名） |
-| 官方协议 | 仅 OpenAI Chat Completions，**没有 Responses API** |
-
-## 2. 协议现状
-
-Kimi 官方文档全文没有出现过 `responses.create`；`platform.kimi.com/docs/llms.txt` 索引里也没有 Responses API 页面。三个消费方（助手、画布文本节点、提示词优化）走本项目现有的 `openai-compatible` 协议即可完整覆盖 Kimi，**不需要等 Responses API 适配器**。
-
-## 3. 模型
-
-| 模型 ID | 简介 | 输入 → 输出 | 上下文 | 最大输出 |
-|---|---|---|---|---|
-| `kimi-k3` | 当前旗舰，2.8 万亿参数，KDA 混合线性注意力，全球首个开源 3 万亿级模型 | 文本、图片、视频 → 文本 | 1,048,576 tokens（1M） | 默认 131,072，最大可设 1,048,576 |
-
-价格（2026-09-24 核对，元/百万 tokens）：缓存命中 2、缓存未命中 20、输出 100；另计缓存写入，TTL 5 分钟为 20、TTL 1 小时为 40，默认 5 分钟。命中仅按缓存命中单价计费，不重复收取缓存写入费用，命中后有效期续期。当前 SDK 未提供 Kimi 账单计算器，不从总输入 tokens 猜测缓存写入量。
-
-K3 是付费解锁模型：**充值后才能调用**，新用户认证赠送的 15 元代金券不能用于 K3。
-
-## 4. 思考模式（始终开启，不可关闭）
-
-- 顶层 `reasoning_effort`：`low` / `high` / `max`，默认 `max`。**没有 `off`**——K2.x 系列的 `thinking` 配置迁移到 K3 时要整段删除，改传 `reasoning_effort`。
-- 多轮对话/工具调用时必须把 API 返回的**完整** assistant message（含 `reasoning_content` 和 `tool_calls`）原样回传，只保留 `content` 会破坏推理连续性。
-
-## 5. 固定采样参数（不要显式传）
-
-`temperature=1.0`、`top_p=0.95`、`n=1`、`presence_penalty=0`、`frequency_penalty=0` 是官方文档明确写出的固定值，"建议不要显式传入"——如果项目通用请求构建层默认带上自己的 `temperature`/`topP`，K3 这边等于被覆盖成无效参数，属于容易被忽视的静默问题。
-
-## 6. 视觉输入（重要限制）
-
-- 图片必须走 `image_url.url` 的 **base64 data URL**（`data:image/png;base64,...`），**不支持公网图片直链**。这与大多数供应商"直接传 URL"的默认假设相反，接入时要单独处理。
-- 视频走 Files API 先上传拿 `file_id`，再用 `video_url.url = "ms://<file-id>"` 引用，用完建议调用 `client.files.delete` 清理。
-- `content` 必须是对象数组，不能是拼好的字符串。
-
-## 7. 结构化输出
-
-`response_format: {type: "json_schema", json_schema: {name, strict: true, schema}}`，只解析 `message.content`，不解析 `reasoning_content`。
-
-## 8. 联网搜索（官方明确提示不建议用于生产）
-
-- 内置工具名 `$web_search`，声明方式和普通 function 不同：`type` 要写成 `"builtin_function"`（不是 `"function"`），且**只需要 `function.name`，不需要 `parameters`**：
-  ```json
-  { "type": "builtin_function", "function": { "name": "$web_search" } }
-  ```
-  `$` 前缀是 Kimi 保留给内置函数的命名空间，普通 `function` 类型的工具名不允许出现 `$`。
-- 执行方式：模型返回 `finish_reason=tool_calls` 且 `tool_call.function.name="$web_search"` 时，调用方**原样把 `arguments` 塞回一条 `role=tool` 消息**即可，不需要真的执行搜索——搜索本身由 Kimi 服务端完成。
-- 价格：¥0.03/次（只在 `finish_reason=tool_calls` 且工具名是 `$web_search` 时收取；如果中途放弃 `tool_calls` 循环，只收这笔工具调用费，不收搜索内容占用的 token 费）。搜索结果本身也会计入下一次请求的 `prompt_tokens`，可从 `tool_call.function.arguments.usage.total_tokens` 读到这部分用量。
-- **官方定价页原文警告**：「联网搜索（`web_search`）正在更新升级中，近期不建议使用该功能，当前文档已经过时」。项目侧如果要接这个能力，应该默认关闭并在 UI 上标注"实验性/暂不稳定"，而不是当作可靠能力直接暴露。
-- 官方更推荐的替代路径是走 Formula 官方工具通道（标准 OpenAI `function` 类型，见「官方工具」文档），但同样标注"联网搜索工具正在更新，近期不建议使用"。
-
-## 9. 动态加载工具（K3 独有能力）
-
-把完整工具定义放进一条 `role=system` 且不含 `content`、只含 `tools` 字段的消息里，可以从对话中间某一轮开始动态生效，不需要在最初就声明全部工具。用于工具数量多、想省 token 或提升工具选择准确率的场景。
-
-## 原始链接索引（均无需登录）
-
-- [Kimi API 概览](https://platform.kimi.com/docs/overview)
-- [Kimi K3 快速开始](https://platform.kimi.com/docs/guide/kimi-k3-quickstart)
-- [推理强度](https://platform.kimi.com/docs/guide/use-reasoning-effort)
-- [使用 Kimi API 的联网搜索功能](https://platform.kimi.com/docs/guide/use-web-search)
-- [如何在 Kimi API 中使用官方工具](https://platform.kimi.com/docs/guide/use-official-tools)
-- [Kimi K3 定价](https://platform.kimi.com/docs/pricing/chat-k3)
-- [当前推理与缓存写入定价（2026-09-24）](https://platform.kimi.com/docs/pricing/chat.md)
-- [联网搜索定价](https://platform.kimi.com/docs/pricing/tools)
-- [使用思考模式](https://platform.kimi.com/docs/guide/use-thinking-models)
-- [Kimi 文档全量索引](https://platform.kimi.com/docs/llms.txt)
+# Kimi（Moonshot）
+
+> 核对时间：2026-08-26；K3.1 Pro 于 2026-11-07 补核。信息来源见文末「原始链接索引」，均无需登录。
+
+## 1. 摘要
+
+| 项目 | 取值 |
+|---|---|
+| `providerId`（项目内约定） | `kimi` / `moonshot` |
+| 对应项目 `adapter` | `openai`（Chat Completions 兼容） |
+| 接入优先级（本项目约定，见 [README 第三节](../README.md)） | 官方**没有** Responses API 也**没有** Anthropic Messages API，Chat Completions 是唯一路径，已实现，无需再排优先级 |
+| 鉴权 | `Authorization: Bearer $MOONSHOT_API_KEY` |
+| Base URL | `https://api.moonshot.cn/v1`（文档站已迁移到 `platform.kimi.com`，但**接口域名仍是 moonshot.cn**，不要混淆两个域名） |
+| 官方协议 | 仅 OpenAI Chat Completions，**没有 Responses API** |
+
+## 2. 协议现状
+
+Kimi 官方文档全文没有出现过 `responses.create`；`platform.kimi.com/docs/llms.txt` 索引里也没有 Responses API 页面。三个消费方（助手、画布文本节点、提示词优化）走本项目现有的 `openai-compatible` 协议即可完整覆盖 Kimi，**不需要等 Responses API 适配器**。
+
+## 3. 模型
+
+| 模型 ID | 简介 | 输入 → 输出 | 上下文 | 最大输出 |
+|---|---|---|---|---|
+| `kimi-k3.1-pro` | 当前旗舰，K3 后继，长程编程与端到端知识工作 | 文本、图片、视频 → 文本 | 1,048,576 tokens（1M） | 默认 131,072，最大可设 1,048,576 |
+| `kimi-k3.1-pro-highspeed` | K3.1 Pro 高速版，速度约 2～3 倍 | 同上 | 同上 | 同上 |
+| `kimi-k3` | 上一代旗舰，2.8 万亿参数，KDA 混合线性注意力 | 文本、图片、视频 → 文本 | 1,048,576 tokens（1M） | 默认 131,072，最大可设 1,048,576 |
+
+价格（2026-09-24 核对，元/百万 tokens）：缓存命中 2、缓存未命中 20、输出 100；另计缓存写入，TTL 5 分钟为 20、TTL 1 小时为 40，默认 5 分钟。命中仅按缓存命中单价计费，不重复收取缓存写入费用，命中后有效期续期。当前 SDK 未提供 Kimi 账单计算器，不从总输入 tokens 猜测缓存写入量。
+
+K3 是付费解锁模型：**充值后才能调用**，新用户认证赠送的 15 元代金券不能用于 K3。K3.1 Pro 可用代金券，Highspeed 不可用。
+
+2026-11-08 用浏览器渲染 [价格页](https://platform.kimi.com/docs/pricing/chat)（无需登录；.md 地址与直接抓取只拿到空表）读到，元/百万 tokens：
+
+| 模型 | 输入（缓存未命中） | 输出 | 缓存命中 | 缓存写入 5 分钟 / 1 小时 |
+|---|---|---|---|---|
+| `kimi-k3.1-pro` | 13 | 68 | 1.3 | 13 / 26 |
+| `kimi-k3.1-pro-highspeed` | 26 | 136 | 1.3（页面原值，未翻倍） | 26 / 52 |
+| `kimi-k3` | 20 | 100 | 2 | 20 / 40 |
+
+不按上下文长度分档；Batch 只支持 K3.1 Pro 与 K3，按标准价 60%。文字折算：官方[简介](https://platform.kimi.com/docs/introduction)写“1 个 Token 大约相当于 1.5-2 个汉字”，英文 1 Token 约 3–4 个字符。
+
+K3.1 Pro 与 K3 的接口契约相同（2026-11-07 读 [K3.1 Pro 快速开始](https://platform.kimi.com/docs/guide/kimi-k3-1-pro-quickstart)、[视觉](https://platform.kimi.com/docs/guide/use-kimi-vision-model.md)、[思考强度](https://platform.kimi.com/docs/guide/use-reasoning-effort.md)）：`reasoning_effort` low / high / max、默认 max、无法关闭；采样参数固定须省略；图片只收 base64 data URL；视频要经 Files API 上传后用 `ms://<file-id>`；`response_format` 支持 `json_schema`（strict）。项目预设：K3.1 Pro、Highspeed、K3 三个模型，图片开、视频不声明（SDK 没有 Files API 上传链路），结构化输出按 schema。官方现在也提供 Responses API（`/v1/responses`），项目仍走 Chat Completions。
+
+## 4. 思考模式（始终开启，不可关闭）
+
+- 顶层 `reasoning_effort`：`low` / `high` / `max`，默认 `max`。**没有 `off`**——K2.x 系列的 `thinking` 配置迁移到 K3 时要整段删除，改传 `reasoning_effort`。
+- 多轮对话/工具调用时必须把 API 返回的**完整** assistant message（含 `reasoning_content` 和 `tool_calls`）原样回传，只保留 `content` 会破坏推理连续性。
+
+## 5. 固定采样参数（不要显式传）
+
+`temperature=1.0`、`top_p=0.95`、`n=1`、`presence_penalty=0`、`frequency_penalty=0` 是官方文档明确写出的固定值，"建议不要显式传入"——如果项目通用请求构建层默认带上自己的 `temperature`/`topP`，K3 这边等于被覆盖成无效参数，属于容易被忽视的静默问题。
+
+## 6. 视觉输入（重要限制）
+
+- 图片必须走 `image_url.url` 的 **base64 data URL**（`data:image/png;base64,...`），**不支持公网图片直链**。这与大多数供应商"直接传 URL"的默认假设相反，接入时要单独处理。
+- 视频走 Files API 先上传拿 `file_id`，再用 `video_url.url = "ms://<file-id>"` 引用，用完建议调用 `client.files.delete` 清理。
+- `content` 必须是对象数组，不能是拼好的字符串。
+
+## 7. 结构化输出
+
+`response_format: {type: "json_schema", json_schema: {name, strict: true, schema}}`，只解析 `message.content`，不解析 `reasoning_content`。
+
+## 8. 联网搜索（官方明确提示不建议用于生产）
+
+- 内置工具名 `$web_search`，声明方式和普通 function 不同：`type` 要写成 `"builtin_function"`（不是 `"function"`），且**只需要 `function.name`，不需要 `parameters`**：
+  ```json
+  { "type": "builtin_function", "function": { "name": "$web_search" } }
+  ```
+  `$` 前缀是 Kimi 保留给内置函数的命名空间，普通 `function` 类型的工具名不允许出现 `$`。
+- 执行方式：模型返回 `finish_reason=tool_calls` 且 `tool_call.function.name="$web_search"` 时，调用方**原样把 `arguments` 塞回一条 `role=tool` 消息**即可，不需要真的执行搜索——搜索本身由 Kimi 服务端完成。
+- 价格：¥0.03/次（只在 `finish_reason=tool_calls` 且工具名是 `$web_search` 时收取；如果中途放弃 `tool_calls` 循环，只收这笔工具调用费，不收搜索内容占用的 token 费）。搜索结果本身也会计入下一次请求的 `prompt_tokens`，可从 `tool_call.function.arguments.usage.total_tokens` 读到这部分用量。
+- **官方定价页原文警告**：「联网搜索（`web_search`）正在更新升级中，近期不建议使用该功能，当前文档已经过时」。项目侧如果要接这个能力，应该默认关闭并在 UI 上标注"实验性/暂不稳定"，而不是当作可靠能力直接暴露。
+- 官方更推荐的替代路径是走 Formula 官方工具通道（标准 OpenAI `function` 类型，见「官方工具」文档），但同样标注"联网搜索工具正在更新，近期不建议使用"。
+
+## 9. 动态加载工具（K3 独有能力）
+
+把完整工具定义放进一条 `role=system` 且不含 `content`、只含 `tools` 字段的消息里，可以从对话中间某一轮开始动态生效，不需要在最初就声明全部工具。用于工具数量多、想省 token 或提升工具选择准确率的场景。
+
+## 原始链接索引（均无需登录）
+
+- [Kimi API 概览](https://platform.kimi.com/docs/overview)
+- [Kimi K3 快速开始](https://platform.kimi.com/docs/guide/kimi-k3-quickstart)
+- [推理强度](https://platform.kimi.com/docs/guide/use-reasoning-effort)
+- [使用 Kimi API 的联网搜索功能](https://platform.kimi.com/docs/guide/use-web-search)
+- [如何在 Kimi API 中使用官方工具](https://platform.kimi.com/docs/guide/use-official-tools)
+- [Kimi K3 定价](https://platform.kimi.com/docs/pricing/chat-k3)
+- [当前推理与缓存写入定价（2026-09-24）](https://platform.kimi.com/docs/pricing/chat.md)
+- [联网搜索定价](https://platform.kimi.com/docs/pricing/tools)
+- [使用思考模式](https://platform.kimi.com/docs/guide/use-thinking-models)
+- [Kimi 文档全量索引](https://platform.kimi.com/docs/llms.txt)
+
+## 2026-10-12 思考请求分支
+
+K3 用 reasoning_effort=low/high/max（不能关闭，关闭映射 low）；K2.6 用 thinking.type=enabled/disabled；K2.7 Code 固定 thinking.type=enabled、thinking.keep=all，不发送 K3 reasoning_effort。未知模型不猜 K3 私有参数。maxOutputTokens 保持原值。来源：[Chat API](https://platform.kimi.com/docs/api/chat)（公开无需登录）。

package/docs/llm-adaptation//344/276/233/345/272/224/345/225/206/MiniMax.md

@@ -1,84 +1,89 @@
-# MiniMax
-
-> 核对时间：2026-08-26。信息来源见文末「原始链接索引」，均无需登录。
-
-## 1. 摘要
-
-| 项目 | 取值 |
-|---|---|
-| `providerId`（项目内约定） | `minimax` |
-| 对应项目 `adapter` | `openai`（Chat Completions / Responses 均可）。官方推荐的 Anthropic 路径在本项目没有可选的 adapter——那个选项从未接通，已删除，见下方"接入优先级" |
-| 官方协议 | Anthropic Messages（官方推荐）、OpenAI Chat Completions、OpenAI Responses API 三选一，同域名不同路径 |
-| 接入优先级（本项目约定，见 [README 第三节](../README.md)） | MiniMax-M3 已默认走 **Responses API** → Chat Completions 兼容；Anthropic 暂不实现、不显示 |
-
-MiniMax 是本次调研 7 家里**唯一把 Anthropic 协议列为默认推荐接入方式**的供应商——官方"通过 SDK 接入"快速开始页第一步就是装 `anthropic` SDK，不是 `openai`；原因是 Anthropic 协议能拿到原生 `thinking` 块和 interleaved thinking，Chat/Responses 路径下这部分体验打折扣。**但本项目按统一的协议接入优先级执行，不因为某一家官方推荐就单独提高 Anthropic 的实现顺序**——MiniMax 官方文档自己也说 Chat Completions 与 Responses 两条路径"功能对等，只是拿不到原生 thinking 块"，所以 Responses API 仍然是够用的第一选择。
-
-## 2. Base URL
-
-| 协议 | Base URL |
-|---|---|
-| Anthropic Messages（推荐） | `https://api.minimaxi.com/anthropic` |
-| OpenAI Chat Completions | `https://api.minimaxi.com/v1`（路径 `/chat/completions`） |
-| OpenAI Responses API | `https://api.minimaxi.com/v1`（路径 `/responses`） |
-
-## 3. 模型清单
-
-| 模型 ID | 简介 | 输入 → 输出 | 上下文 | 最大输出 |
-|---|---|---|---|---|
-| `MiniMax-M3` | 当前最新旗舰，原生多模态，1M 上下文，面向 Frontier Coding、复杂推理、Agent | 文本、图片、视频 → 文本 | 1,000,000 | 官方建议 131,072，硬上限 524,288 |
-
-`MiniMax-M2.7`（含 `-highspeed`）仍在正常提供服务，属于上一代仍在售的并行线，不是 M3 的档位变体；`M2.5`/`M2.1`/`M2` 系列已归入官方"历史模型"分组。
-
-### 价格（元/百万 tokens，当前促销"永久五折"后）
-
-| 输入长度 | 输入 | 输出 | 缓存读取 |
-|---|---|---|---|
-| ≤ 512K | 2.10 | 8.40 | 0.42 |
-| > 512K | 4.20 | 16.80 | 0.84 |
-
-`service_tier: "priority"` 优先服务档按上表 1.5 倍计费，可换取更快响应与更低失败率。
-
-## 4. Anthropic 协议接入要点（官方推荐路径，但本项目最低优先级，仅供顺手接入时参考）
-
-```python
-import anthropic
-client = anthropic.Anthropic(base_url="https://api.minimaxi.com/anthropic", api_key="<KEY>")
-message = client.messages.create(model="MiniMax-M3", max_tokens=1000, messages=[...])
-for block in message.content:
-    if block.type == "thinking": ...   # 原生 thinking 块
-    elif block.type == "text": ...
-```
-
-- 支持 `thinking` 内容块和 interleaved thinking（推理与工具调用交替）——这是官方文档反复强调的 M3 核心卖点，Chat Completions 路径下只能拿到扁平化的 `reasoning_content` 字符串，信息密度不如原生 `thinking` 块。
-- 官方 Mini-Agent 示例项目就是用 Anthropic 协议 + interleaved thinking 演示"如何用 M3 搭 Agent"的最佳实践，可作为项目内 Agent 集成的参考实现。
-
-## 5. 联网搜索（Server Tools，Beta，两个协议都支持——这与此前认知不同）
-
-**更正**：此前认为 MiniMax 的 `web_search` 只在 Anthropic Messages 文档出现，OpenAI/Responses 路径不支持——这是过时信息。**官方当前 Server Tools 文档明确写：Anthropic Messages API 和 OpenAI Responses API 都支持**，只是工具类型标识不同：
-
-| 接口 | 工具声明 |
-|---|---|
-| Anthropic Messages API | `{"type": "web_search_20250305", "name": "web_search"}` |
-| OpenAI Responses API | `{"type": "web_search"}` |
-
-服务端工具（Server Tools）与项目自研的 function-calling 工具是两套机制：模型在 MiniMax 服务端自动执行搜索并把结果直接嵌进响应，调用方不需要多轮回传 `tool_result`，一次请求内完成。
-
-- Anthropic 路径响应里会依次出现 `text`（引导语）→ `server_tool_use`（`name=web_search`, `input.query`）→ `web_search_tool_result`（含 `title`/`url`/`page_age`/`content`）→ `text`（最终答案），直接读最后一个 `text` 块即可。
-- Responses API 路径的 `output` 数组包含 `web_search_call`（含 `action.query`）和 `message`，可以直接读顶层聚合字段 `output_text`。
-- **纯 Chat Completions（`/v1/chat/completions`）不支持这个工具**——只有 Anthropic Messages 和 Responses 两条路径能用，选型时要注意。
-- 价格 ¥0.03/次；处于 **Beta 阶段**，官方提示行为与参数可能随时调整，服务端全程执行导致单次请求耗时可能更长，客户端超时要放宽。
-
-## 6. 兼容性说明
-
-- OpenAI Chat Completions 与 Anthropic Messages 是"等价的两套非流式样例"，官方文档明确"如果你的项目已经接入 OpenAI SDK，把 base_url 和 model 换成 MiniMax 的值即可直接复用，无需迁移 SDK"——即两条路径功能对等（除服务端工具的可用面略有差异），选哪个更多是团队已有技术栈的问题，不是能力取舍。这也是本项目仍把 Responses API 排在 Anthropic 前面的依据：不用 Anthropic 也不会丢失核心能力，只是拿不到原生 `thinking` 块和 interleaved thinking 这部分体验加成。
-- `LlmProviderConfig.adapter` 只保留内部供应商特性标识；协议由 `apiProtocol` 和预制模型矩阵决定。Anthropic 虽是 MiniMax 官方推荐路径，但项目暂不实现、不显示；MiniMax-M3 由 SDK 自动走 Responses。
-
-## 原始链接索引（均无需登录）
-
-- [模型概览](https://platform.minimaxi.com/docs/guides/models-intro)
-- [模型调用（URL 配置、双协议示例）](https://platform.minimaxi.com/docs/guides/text-generation)
-- [通过 SDK 接入（Anthropic SDK 快速开始）](https://platform.minimaxi.com/docs/guides/quickstart-sdk)
-- [服务端工具（Server Tools / web_search）](https://platform.minimaxi.com/docs/guides/server-tools)
-- [工具使用 & 交错思维链](https://platform.minimaxi.com/docs/guides/text-m3-function-call)
-- [按量计费](https://platform.minimaxi.com/docs/guides/pricing-paygo)
-- [MiniMax 文档全量索引](https://platform.minimaxi.com/docs/llms.txt)
+# MiniMax
+
+> 核对时间：2026-08-26；M3.1 Flash 与国内域名于 2026-11-07 补核。信息来源见文末「原始链接索引」，均无需登录。
+
+## 1. 摘要
+
+| 项目 | 取值 |
+|---|---|
+| `providerId`（项目内约定） | `minimax` |
+| 对应项目 `adapter` | `openai`（Chat Completions / Responses 均可）。官方推荐的 Anthropic 路径在本项目没有可选的 adapter——那个选项从未接通，已删除，见下方"接入优先级" |
+| 官方协议 | Anthropic Messages（官方推荐）、OpenAI Chat Completions、OpenAI Responses API 三选一，同域名不同路径 |
+| 接入优先级（本项目约定，见 [README 第三节](../README.md)） | MiniMax-M3 已默认走 **Responses API** → Chat Completions 兼容；Anthropic 暂不实现、不显示 |
+
+MiniMax 是本次调研 7 家里**唯一把 Anthropic 协议列为默认推荐接入方式**的供应商——官方"通过 SDK 接入"快速开始页第一步就是装 `anthropic` SDK，不是 `openai`；原因是 Anthropic 协议能拿到原生 `thinking` 块和 interleaved thinking，Chat/Responses 路径下这部分体验打折扣。**但本项目按统一的协议接入优先级执行，不因为某一家官方推荐就单独提高 Anthropic 的实现顺序**——MiniMax 官方文档自己也说 Chat Completions 与 Responses 两条路径"功能对等，只是拿不到原生 thinking 块"，所以 Responses API 仍然是够用的第一选择。
+
+## 2. Base URL
+
+| 协议 | Base URL |
+|---|---|
+| Anthropic Messages（推荐） | `https://api.minimax.cn/anthropic` |
+| OpenAI Chat Completions | `https://api.minimax.cn/v1`（路径 `/chat/completions`） |
+| OpenAI Responses API | `https://api.minimax.cn/v1`（路径 `/responses`） |
+
+官方国内文档现在写的接口域名是 `api.minimax.cn`；旧域名 `api.minimaxi.com` 2026-11-07 实测仍可用（未带密钥请求两边都返回 401），项目预设改用新域名。
+
+## 3. 模型清单
+
+| 模型 ID | 简介 | 输入 → 输出 | 上下文 | 最大输出 |
+|---|---|---|---|---|
+| `MiniMax-M3.1-Flash` | 高性价比多模态编程模型，输出可达 200+ TPS | 文本、图片、视频 → 文本 | 1,000,000（输入加输出） | 官方未写 |
+| `MiniMax-M3` | 旗舰，原生多模态，1M 上下文，面向 Frontier Coding、复杂推理、Agent | 文本、图片、视频 → 文本 | 1,000,000 | 官方建议 131,072，硬上限 524,288 |
+
+M3.1 Flash（2026-11-07 读 [模型调用](https://platform.minimax.cn/docs/guides/text-generation)、[OpenAI 兼容接口](https://platform.minimax.cn/docs/api-reference/text-openai-api)、[价格](https://platform.minimax.cn/docs/pricing/overview)）：思考强度 `reasoning_effort` 为 low / medium / high / xhigh / max，省略即 max，**无法关闭**（传 none 或 thinking disabled 返回 400）；temperature 与 top_p 被固定（1 与 0.95），项目不下发；不支持音频输入；官方未提结构化输出，项目不声明；价格 ¥1 / ¥4 / 缓存读 ¥0.1 每百万 tokens。项目走 Chat Completions，思考「关闭」时发最低档 low。
+
+`MiniMax-M2.7`（含 `-highspeed`）仍在正常提供服务，属于上一代仍在售的并行线，不是 M3 的档位变体；`M2.5`/`M2.1`/`M2` 系列已归入官方"历史模型"分组。
+
+### 价格（元/百万 tokens，当前促销"永久五折"后）
+
+| 输入长度 | 输入 | 输出 | 缓存读取 |
+|---|---|---|---|
+| ≤ 512K | 2.10 | 8.40 | 0.42 |
+| > 512K | 4.20 | 16.80 | 0.84 |
+
+`service_tier: "priority"` 优先服务档按上表 1.5 倍计费，可换取更快响应与更低失败率。
+
+## 4. Anthropic 协议接入要点（官方推荐路径，但本项目最低优先级，仅供顺手接入时参考）
+
+```python
+import anthropic
+client = anthropic.Anthropic(base_url="https://api.minimaxi.com/anthropic", api_key="<KEY>")
+message = client.messages.create(model="MiniMax-M3", max_tokens=1000, messages=[...])
+for block in message.content:
+    if block.type == "thinking": ...   # 原生 thinking 块
+    elif block.type == "text": ...
+```
+
+- 支持 `thinking` 内容块和 interleaved thinking（推理与工具调用交替）——这是官方文档反复强调的 M3 核心卖点，Chat Completions 路径下只能拿到扁平化的 `reasoning_content` 字符串，信息密度不如原生 `thinking` 块。
+- 官方 Mini-Agent 示例项目就是用 Anthropic 协议 + interleaved thinking 演示"如何用 M3 搭 Agent"的最佳实践，可作为项目内 Agent 集成的参考实现。
+
+## 5. 联网搜索（Server Tools，Beta，两个协议都支持——这与此前认知不同）
+
+**更正**：此前认为 MiniMax 的 `web_search` 只在 Anthropic Messages 文档出现，OpenAI/Responses 路径不支持——这是过时信息。**官方当前 Server Tools 文档明确写：Anthropic Messages API 和 OpenAI Responses API 都支持**，只是工具类型标识不同：
+
+| 接口 | 工具声明 |
+|---|---|
+| Anthropic Messages API | `{"type": "web_search_20250305", "name": "web_search"}` |
+| OpenAI Responses API | `{"type": "web_search"}` |
+
+服务端工具（Server Tools）与项目自研的 function-calling 工具是两套机制：模型在 MiniMax 服务端自动执行搜索并把结果直接嵌进响应，调用方不需要多轮回传 `tool_result`，一次请求内完成。
+
+- Anthropic 路径响应里会依次出现 `text`（引导语）→ `server_tool_use`（`name=web_search`, `input.query`）→ `web_search_tool_result`（含 `title`/`url`/`page_age`/`content`）→ `text`（最终答案），直接读最后一个 `text` 块即可。
+- Responses API 路径的 `output` 数组包含 `web_search_call`（含 `action.query`）和 `message`，可以直接读顶层聚合字段 `output_text`。
+- **纯 Chat Completions（`/v1/chat/completions`）不支持这个工具**——只有 Anthropic Messages 和 Responses 两条路径能用，选型时要注意。
+- 价格 ¥0.03/次；处于 **Beta 阶段**，官方提示行为与参数可能随时调整，服务端全程执行导致单次请求耗时可能更长，客户端超时要放宽。
+
+## 6. 兼容性说明
+
+- OpenAI Chat Completions 与 Anthropic Messages 是"等价的两套非流式样例"，官方文档明确"如果你的项目已经接入 OpenAI SDK，把 base_url 和 model 换成 MiniMax 的值即可直接复用，无需迁移 SDK"——即两条路径功能对等（除服务端工具的可用面略有差异），选哪个更多是团队已有技术栈的问题，不是能力取舍。这也是本项目仍把 Responses API 排在 Anthropic 前面的依据：不用 Anthropic 也不会丢失核心能力，只是拿不到原生 `thinking` 块和 interleaved thinking 这部分体验加成。
+- `LlmProviderConfig.adapter` 只保留内部供应商特性标识；协议由 `apiProtocol` 和预制模型矩阵决定。Anthropic 虽是 MiniMax 官方推荐路径，但项目暂不实现、不显示；MiniMax-M3 由 SDK 自动走 Responses。
+
+## 原始链接索引（均无需登录）
+
+- [模型概览](https://platform.minimax.cn/docs/guides/models-intro)
+- [模型调用（URL 配置、双协议示例）](https://platform.minimax.cn/docs/guides/text-generation)
+- [通过 SDK 接入（Anthropic SDK 快速开始）](https://platform.minimax.cn/docs/guides/quickstart-sdk)
+- [服务端工具（Server Tools / web_search）](https://platform.minimax.cn/docs/guides/server-tools)
+- [工具使用 & 交错思维链](https://platform.minimax.cn/docs/guides/text-m3-function-call)
+- [按量计费](https://platform.minimax.cn/docs/guides/pricing-paygo)
+- [MiniMax 文档全量索引](https://platform.minimax.cn/docs/llms.txt)