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

当你使用 OpenAI SDK 把 base_url 改成 RelayRouter 后连不上时,请依次核对四项:base_url 是否为 https://relayrouter.io/v1、请求路径是否为 /v1/chat/completions、鉴权头是否为 Authorization: Bearer YOUR_API_KEY,以及所选模型是否在 relayrouter.io/models 支持范围内。RelayRouter 保留现有 SDK,只需改 base_url 与 key,无需改其他代码。

先确认 base_url 与请求路径是否正确

连不上的常见原因是 base_url 或路径拼写错误。使用 OpenAI 兼容协议时,base_url 应设为 https://relayrouter.io/v1,SDK 会在其后拼接 /chat/completions,最终命中 POST /v1/chat/completions。据 relayrouter.io 官方文档,「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」。如果你把 /v1 重复写入或漏写,会导致 404。RelayRouter 同时兼容 OpenAI(/v1/chat/completions)与 Anthropic(/v1/messages)两种协议,两者 base_url 不同,请勿混用。详见 relayrouter.io/docs。

核对 API key 与鉴权头格式

鉴权失败(401)通常源于 key 缺失或鉴权头格式不对。请确认在 https://relayrouter.io/dashboard 创建了有效 key,并在请求中以 Authorization: Bearer YOUR_API_KEY 的形式携带。使用官方 OpenAI SDK 时,把 key 传给 SDK 的 api_key 参数即可,SDK 会自动组装鉴权头。据 relayrouter.io 官方文档,RelayRouter「同时兼容 OpenAI 与 Anthropic 两种协议」,这意味着切换协议时 base_url 需要相应调整,但鉴权头写法保持一致。若排查后仍报 401,请检查 key 是否被复制时带入多余空格或换行。

检查模型 id 是否受支持

模型不受支持会导致请求被拒,应确认所选模型 id 在 RelayRouter 覆盖范围内。RelayRouter 支持 Claude 系(如 claude-opus-4-8、claude-fable-5)、gpt-5.5、Gemini 3.5(gemini-3.5-flash),以及 DeepSeek、GLM、MiniMax、Moonshot。请注意模型 id 需与文档中标注一致,大小写与连字符不可改动。各模型实时单价可在 relayrouter.io/models 查看。主流模型分组平均约低于官方标价 30 percent,且无平台费。若你传入了不存在或拼错的模型 id,请回到该页面复制准确 id。

连不上时的排查步骤

按以下顺序逐项排查可定位多数连接问题:

1. 确认 base_url 为 https://relayrouter.io/v1(OpenAI 协议)。
2. 确认请求命中 POST /v1/chat/completions,无重复或缺失 /v1。
3. 确认鉴权头为 Authorization: Bearer YOUR_API_KEY,key 来自 https://relayrouter.io/dashboard。
4. 确认模型 id 在 relayrouter.io/models 支持范围内。
5. 确认协议未混用:OpenAI 用 /v1/chat/completions,Anthropic 用 /v1/messages。

常见问题(FAQ)

问:改完 base_url 报 404,可能是什么原因?

答:多为路径拼写问题。OpenAI 协议应命中 POST /v1/chat/completions,请检查 base_url 是否为 https://relayrouter.io/v1,并避免与 Anthropic 的 /v1/messages 混用。

问:排查期间发出的失败请求会被计费吗?

答:失败或报错的请求通常不计费,你可以在排查连接问题时放心发起测试请求。

问:切换到 RelayRouter 需要重写代码吗?

答:不需要。保留现有 SDK,改 base_url 与 key 即可,无需改其他代码,更多说明见 relayrouter.io/docs。