OpenAI 兼容 API
更换模型路由，同时保留 OpenAI 客户端格式
OpenAI 兼容 API 允许你在修改 Base URL、Key 和模型 ID 后继续使用熟悉的 OpenAI SDK 请求格式。兼容性取决于具体操作，因此 KeepRouter 会在每个模型页标出支持端点。
最后复核 2026-08-15 · 编辑复核: KeepRouter Editorial
先改配置，再改代码
对兼容聊天模型，把 OpenAI 客户端 Base URL 设为 https://keeprouter.com/v1，填入 KeepRouter API Key，并选择目录中的模型 ID。消息数组、流式标志和受支持的工具定义继续保持 OpenAI 客户端格式。
OpenAI SDK 接入指南提供 Python 和 TypeScript 示例；OpenAPI 文档则是 KeepRouter 公共 /v1 路由的机器可读契约。
兼容性取决于具体路由
“OpenAI 兼容”不等于“所有 OpenAI 端点和参数都适用于每个模型”。KeepRouter 提供 Chat Completions、Responses 等多种 OpenAI 形态路由，并在配置时提供模态专用端点。所选模型必须在该路由可用；供应商专用参数也可能被忽略或拒绝。
迁移生产工作负载前，请验证：
- 模型页列出了 SDK 方法实际调用的路由；
- 流式结束事件符合解析器预期；
- 工具名称、参数和续轮消息能完整往返；
- 最终响应或流事件中存在用量字段；
- 超时与重试对 4xx、5xx 有不同处理；
- 明确设置输出 token 上限。
更安全的迁移顺序
先发送一个确定性的非流式请求，再开启流式；随后加入工具或结构化输出；再重放一个代表性生产提示词并比较 token 与响应形态；最后把模型 ID 和 Key 移入部署配置，确保回滚不需要重新发布代码。
何时使用 Responses 路由
当所选模型和客户端工作流需要 Responses 对象与事件模型时，使用 /v1/responses。已有的消息式集成若不需要 Responses 专有语义，可继续用 Chat Completions。Responses 与 Chat Completions 指南会解释迁移取舍。
让实时目录参与发布
当前模型 ID、价格和路由兼容性以目录为准。不要把复制出来的模型清单写死在应用里。发布时解析获批 ID，把 Key 限定到这些模型，并在配置模型从白名单或健康检查中消失时告警。
常见问题
可以使用官方 OpenAI SDK 吗？
可以，但仅限受支持的路由。设置 Base URL 和 KeepRouter Key，再选择列出对应端点的模型。
每个模型都支持 Responses API 吗？
不是。Responses 支持取决于路由和模型，请在选择前检查模型页与实时目录。
供应商专用参数会生效吗？
只有所选路由和上游支持时才会生效。不支持的参数可能被忽略或拒绝，请测试准确请求形态。
切换 Base URL 前应该测试什么？
请测试非流式、流式、工具、用量计费、错误、超时以及带输出上限的真实生产 payload。