多模型切换与接口兼容边界
本页帮助你为任务选择模型并核对兼容范围。请求迁移见 API 接入与迁移；工具设置从 文档首页进入。
按能力选择模型，不只比较名字
| 任务 | 要核对的能力 | 入口 |
|---|---|---|
| 普通聊天 | Chat 或原生协议、上下文、输入输出价格 | 模型与版本目录 |
| Agent / 代码 | 工具调用、Responses/Messages、工具参数兼容 | Codex · OpenCode |
| 图片生成 | Images 或原生图片接口、规格、base64/URL | 图片生成与保存 |
| 视频 | 任务协议、时长/分辨率、创建查询下载 | 视频任务全流程 |
| 知识库 | Embedding 维度、向量存储、聊天模型分别配置 | 知识库接入 |
如何配置不同模型提供商
- 从当前模型目录复制真实 ID，核对协议和分组。
- 选择匹配的 SDK/provider，而不是只修改展示名称。
- 保持请求字段和响应解析属于同一协议。
- 先测短文本，再测工具、多模态和流式。
Chat 使用 messages/choices，Responses 使用 input/output，Messages 使用 content，Gemini 原生使用 contents/candidates。统一 Key 不意味着这些字段相同。协议对照。
为什么能读取模型，却调用失败
目录查询与生成权限是不同检查。检查令牌额度、模型白名单、分组协议、SDK 最终路径；部分工具还限制 BYOK 模型类别。按错误码检查具体字段。
模型切换的兼容清单
| 切换前 | 需要重新验证 |
|---|---|
| 更换模型 ID | 工具 schema、输出结构、上下文和限速 |
| 更换协议 | 请求体、鉴权、流式事件、响应解析 |
| 更换图片 / 视频接口 | 任务状态、返回 URL、下载有效期、计费规格 |
| 更换 Embedding | 维度及向量索引；必要时重新嵌入文档 |
验证与价格
真实调用记录列出本次通过的模型和未验证功能。实时模型价格提供当前模型与分组价格；费用计算说明计价单位，不保证每个模型所有功能都已实测。