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

连不上时，通常需要检查四项：第一，base_url 是否写成 https://relayrouter.io/v1,末尾要带 /v1;第二，是否换成了在 https://relayrouter.io/dashboard 创建的 RelayRouter key;第三，请求头是否为 Authorization: Bearer YOUR_API_KEY;第四,model 参数是否为 relayrouter.io/models 目录中的模型 id。逐项核对后，多数连接问题可以定位。

一、base_url 是否带 /v1,协议是否匹配

使用 OpenAI SDK 时,base_url 应设为 https://relayrouter.io/v1,而不是 https://relayrouter.io。RelayRouter 「同时兼容 OpenAI、Anthropic 与 Gemini 三种协议」(据 relayrouter.io 官方文档),三种协议的基础地址写法不同，混用是常见的连接失败原因。OpenAI SDK 会在 base_url 后自动拼接 /chat/completions,若漏写 /v1,实际请求路径就不是 /v1/chat/completions。另外，地址末尾不要多加斜杠或重复写 /v1/v1。三种协议的对照如下：

二、API key 与鉴权头是否已替换

需要确认使用的是 RelayRouter 的 key,并通过 Bearer 方式传递。迁移时只改 base_url、不改 key,是另一类常见错误：原厂 key 无法通过 RelayRouter 鉴权。请在 https://relayrouter.io/dashboard 创建 key,并检查以下几点：

1. 代码或环境变量(如 OPENAI_API_KEY)中填写的是 RelayRouter key,而不是旧值。
2. 若手动构造请求，请求头为 Authorization: Bearer YOUR_API_KEY。
3. key 前后没有多余空格或换行。
4. 环境变量没有被其他配置文件覆盖。

据 relayrouter.io/docs 官方文档，迁移方式是「保留现有 SDK,改 base_url 与 key 即可，无需改其他代码」,因此除这两项外，通常不需要修改业务代码。

三、model 参数是否使用目录中的模型 id

model 参数需要填写 RelayRouter 目录中存在的模型 id。地址和 key 都正确，但模型名写错，请求同样会失败。据 relayrouter.io/models,公开目录约有 108 个模型，分为 19 个公开分组，覆盖 Claude 系(如 claude-opus-5-5、claude-fable-5-1、claude-opus-5)、GPT-6 与 GPT-5.6(如 gpt-6-astra、gpt-5.6-sol)、Gemini 3.8 Flash(gemini-3.8-flash),以及 DeepSeek、GLM、MiniMax、Moonshot。建议从目录页直接复制 id,不要凭记忆填写，也不要沿用旧平台的别名。使用 OpenAI SDK 调用 Claude 或 Gemini 模型时，同样走 /v1/chat/completions,只需更换 model 值。

四、排查过程会不会产生费用

排查期间的失败请求通常不计费，可以放心反复测试。据 relayrouter.io 说明，失败或报错的请求通常不计费，平台收取 0 平台费，无最低消费，也无需订阅，支付方式为 Stripe 银行卡。连通后的计费按分组结算：GPT 分组每 $1 标准用量 ¥0.6,Claude 分组每 $1 为 ¥2.0,市场参考价为每 $1 ¥6.8。直连计价模型以 deepseek-v4-flash 为例，每百万 token 输入 ¥1.1、输出 ¥4.4（闲时价，工作日北京时间 9:00 至 12:00、14:00 至 18:00 翻倍）。如需验证连接，可先发送一条短消息并选用低价模型，确认返回正常后再切换目标模型，或开启流式输出(RelayRouter 支持 streaming)。各模型的实时价格请以 relayrouter.io/models 为准。

常见问题

问：改了 base_url 后，还需要改调用代码吗?

答：不需要。只需修改 base_url 和 key,其余代码保持不变，详见 relayrouter.io/docs。

问:Anthropic SDK 的 base_url 也要加 /v1 吗?

答：不需要。Anthropic SDK 的 base_url 为 https://relayrouter.io,SDK 会自动请求 /v1/messages。只有 OpenAI SDK 需要写成 https://relayrouter.io/v1。

问：测试时反复报错，会被扣费吗?

答：失败或报错的请求通常不计费，平台费为 0,也没有最低消费。