OpenAI SDK 导读
对大多数团队，这仍然是迁移到 TheRouter.ai 成本最低的路径。
如果你的代码已经跑在 OpenAI SDK 上，迁移到 TheRouter.ai 通常不需要重写业务逻辑。 绝大多数情况下，你只需要改 base URL、API key 和模型命名方式。 这页先说明最短迁移路径和兼容边界。
什么时候优先看这页
如果你不是直接在 Cursor / Claude Code 里使用，而是已有后端或服务在调用 OpenAI SDK， 这通常是最该先看的页面。
最短迁移方式
改 base URL，换成 TheRouter 的 key，并把模型 ID 改成 provider/model 形式。
TypeScript
const client = new OpenAI({
baseURL: "https://api.therouter.ai/v1",
apiKey: process.env.THEROUTER_API_KEY,
});先验证什么
先验证两件事：`/v1/models` 返回了你预期模型；一次最简单的 completion 能成功返回。
bash
curl https://api.therouter.ai/v1/models \
-H "Authorization: Bearer $THEROUTER_API_KEY" | head -c 400兼容边界在哪里
- 标准聊天、流式、结构化输出这类路径通常兼容度最高。
- 高级 beta 参数不一定对所有 provider 完全等价。
- 模型名不再是单一厂商 ID，而是
provider/model别名。 - 如果你要接 fallback、skills 或 BYOK，最好再看对应导读页。
最容易踩的坑
text
1. 只改了 base URL，没改模型命名
2. 继续使用上游原始模型 ID，而不是 provider/model 别名
3. 没有先用 /v1/models 验证可用模型
4. 把 OpenAI SDK 路径和 Claude Code 的 Anthropic 兼容路径混为一谈常见失败原因
大多数接入失败不是 SDK 不兼容，而是 key、base URL 或模型 ID 不对。