# 更换模型路由，同时保留 OpenAI 客户端格式

> OpenAI 兼容 API 允许你在修改 Base URL、Key 和模型 ID 后继续使用熟悉的 OpenAI SDK 请求格式。兼容性取决于具体操作，因此 KeepRouter 会在每个模型页标出支持端点。

_最后复核 2026-08-15 · [编辑复核](https://keeprouter.com/editorial-policy#editorial-team)_

## 先改配置，再改代码

对兼容聊天模型，把 OpenAI 客户端 Base URL 设为 `https://keeprouter.com/v1`，填入 KeepRouter API Key，并选择目录中的模型 ID。消息数组、流式标志和受支持的工具定义继续保持 OpenAI 客户端格式。

[OpenAI SDK 接入指南](/use-cases/openai-sdk)提供 Python 和 TypeScript 示例；[OpenAPI 文档](/api/openapi.json)则是 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 指南](/zh/blog/responses-api-vs-chat-completions)会解释迁移取舍。

## 让实时目录参与发布

当前模型 ID、价格和路由兼容性以目录为准。不要把复制出来的模型清单写死在应用里。发布时解析获批 ID，把 Key 限定到这些模型，并在配置模型从白名单或健康检查中消失时告警。

## 常见问题

### 可以使用官方 OpenAI SDK 吗？

可以，但仅限受支持的路由。设置 Base URL 和 KeepRouter Key，再选择列出对应端点的模型。

### 每个模型都支持 Responses API 吗？

不是。Responses 支持取决于路由和模型，请在选择前检查模型页与实时目录。

### 供应商专用参数会生效吗？

只有所选路由和上游支持时才会生效。不支持的参数可能被忽略或拒绝，请测试准确请求形态。

### 切换 Base URL 前应该测试什么？

请测试非流式、流式、工具、用量计费、错误、超时以及带输出上限的真实生产 payload。

## 参考的一手资料

1. [OpenAI API reference](https://platform.openai.com/docs/api-reference)
2. [KeepRouter OpenAPI](https://keeprouter.com/api/openapi.json)

## 继续阅读

- [openai sdk](https://keeprouter.com/use-cases/openai-sdk.md)
- [OpenAI 兼容 API 迁移清单](https://keeprouter.com/zh/blog/openai-compatible-api-migration-checklist.md)
- [Responses API 与 Chat Completions：按契约选择，而不是追新](https://keeprouter.com/zh/blog/responses-api-vs-chat-completions.md)
- [模型路由](https://keeprouter.com/zh/features/model-routing.md)

## 用同一个客户端调用免费模型

修改 Base URL 和 Key，发送有上限的请求，并检查记录的用量。

[创建免费 Key](https://keeprouter.com/login?returnTo=%2Fconsole%2Fkeys%3Fmodel%3Dfree) · [实时模型与价格](https://keeprouter.com/models.md)