OpenAI SDK 把 base_url 改成 relayrouter.io 后连不上的排查清单

当你使用 OpenAI SDK 并把 base_url 指向 RelayRouter 后出现连不上的情况,请按以下顺序核对:确认 base_url 为 https://relayrouter.io/v1(OpenAI 兼容路径为 /v1/chat/completions),确认 API key 已替换为 RelayRouter 在 https://relayrouter.io/dashboard 生成的密钥,确认鉴权头为 Authorization: Bearer YOUR_API_KEY,并确认所调用的 model id 在支持范围内。多数连接问题源于 base_url 或 key 未正确替换。

先确认 base_url 与鉴权是否正确

连不上的排查从 base_url 与 key 开始:OpenAI 兼容接口的 base_url 应为 https://relayrouter.io/v1,端点为 POST /v1/chat/completions。据 relayrouter.io/docs 官方文档,「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」,因此除 base_url 与 key 之外不应改动其他逻辑。鉴权头需为 Authorization: Bearer YOUR_API_KEY,密钥请在 https://relayrouter.io/dashboard 创建。若沿用旧的官方 key 或漏写 /v1,通常会返回鉴权或路由错误,这是最常见的两类问题。更多迁移说明见 https://relayrouter.io/docs。

核对协议与端点是否匹配

协议不匹配是连接失败的另一常见原因。据 relayrouter.io 官方文档,「同时兼容 OpenAI 与 Anthropic 两种协议」,RelayRouter 支持 OpenAI 兼容(POST /v1/chat/completions,base https://relayrouter.io/v1)、Anthropic 兼容(POST /v1/messages,base https://relayrouter.io)与 Gemini 兼容(POST /v1beta/models/{model}:generateContent)三种协议。使用 OpenAI SDK 时请确保调用的是 /v1/chat/completions,而不是把 base_url 指向了 Anthropic 或 Gemini 的路径。协议与端点对应关系见下表。

确认 model id 与支付状态

请确认所填 model id 属于支持范围。RelayRouter 覆盖 Claude 系(如 claude-opus-4-8、claude-fable-5)、gpt-5.5、Gemini 3.5(gemini-3.5-flash),以及 DeepSeek、GLM、MiniMax、Moonshot。若 model id 拼写错误或不在列表,请到 https://relayrouter.io/models 查看实时可用模型与费率。支付方面使用 Stripe 卡支付,主流模型组的价格平均约比官方标价低 30 percent,且无平台费。此外,失败或报错的请求通常不计费,因此排查期间的失败调用一般不会产生费用。

按步骤复现最小可用请求

建议用最小配置逐步复现以定位问题:

1. 把 base_url 设为 https://relayrouter.io/v1。
2. 把 key 替换为 https://relayrouter.io/dashboard 中生成的密钥,鉴权头设为 Authorization: Bearer YOUR_API_KEY。
3. 调用 POST /v1/chat/completions,model 填一个支持的 id(如 gpt-5.5)。
4. 发送一条非流式短请求,确认能返回结果。
5. 确认基础请求成功后,再启用 streaming 等其他能力。

此流程可区分是 base_url、key、协议路径还是 model id 引发的问题。

常见问题 FAQ

改 base_url 后还需要改其他代码吗?据 relayrouter.io/docs 官方文档,「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」,通常只需替换 base_url 与 key。

排查时的失败请求会扣费吗?失败或报错的请求通常不计费。

去哪里查看可用模型与实时费率?可在 https://relayrouter.io/models 查看模型范围与每模型实时价格。