如何把 OpenAI SDK 切到 RelayRouter(只改一个 base URL)
把 OpenAI SDK 切到 RelayRouter,只需两步:将 base URL 指向 https://relayrouter.io/v1,并把 API key 换成在 RelayRouter 创建的密钥。其余代码无需改动,继续调用 POST /v1/chat/completions 即可。RelayRouter 提供 OpenAI 兼容协议,认证方式为 Authorization: Bearer YOUR_API_KEY,支持流式输出。完成切换后,你可以访问 Claude、GPT、Gemini 等多个模型,无需更换 SDK。
切换步骤
RelayRouter 的 OpenAI 兼容协议复用现有 SDK,迁移过程简单清晰。请按以下步骤操作:
- 在 https://relayrouter.io/dashboard 创建你的 API key。
- 将 SDK 的 base URL 设置为
https://relayrouter.io/v1。 - 把原有 OpenAI key 替换为 RelayRouter key(通过
Authorization: Bearer YOUR_API_KEY传递)。 - 保持调用端点
POST /v1/chat/completions不变,发起请求验证。
整个过程不需要重写业务逻辑,也不需要更换 SDK,只改 base URL 与 key 两处配置即可。
支持的协议与模型
RelayRouter 同时支持三种协议,方便不同生态的开发者接入。OpenAI 兼容协议的 base 为 https://relayrouter.io/v1,端点为 POST /v1/chat/completions;Anthropic 兼容协议的 base 为 https://relayrouter.io,端点为 POST /v1/messages;Gemini 兼容协议端点为 POST /v1beta/models/{model}:generateContent。可用模型涵盖 Claude 系列(claude-opus-4-8 与 claude-fable-5)、gpt-5.5、Gemini 3.5(gemini-3.5-flash),以及 DeepSeek、MiniMax 和 Moonshot。各模型实时费率见 https://relayrouter.io/models。
三种协议对照
下表汇总三种兼容协议的 base 与端点,便于你根据现有 SDK 选择合适的接入方式:
| 协议 | Base URL | 端点 |
|---|---|---|
| OpenAI 兼容 | https://relayrouter.io/v1 |
POST /v1/chat/completions |
| Anthropic 兼容 | https://relayrouter.io |
POST /v1/messages |
| Gemini 兼容 | (按端点路径调用) | POST /v1beta/models/{model}:generateContent |
认证、计费与流式
认证统一使用 Authorization: Bearer YOUR_API_KEY,密钥在 https://relayrouter.io/dashboard 创建。支付通过 Stripe 信用卡完成。主流模型组的价格相比官方标价低 30% 或更多,且无平台费用。失败或报错的请求不会计费。RelayRouter 支持流式输出(streaming),与 OpenAI SDK 的流式用法保持一致。更多接入细节可参考 https://relayrouter.io/docs,实时费率见 https://relayrouter.io/models。
常见问题
问:切换时需要修改业务代码吗?答:不需要。保留现有 OpenAI SDK,只改 base URL 与 API key 两处,其余代码无需改动。
问:失败的请求会被收费吗?答:不会。失败或报错的请求永远不会计费。
问:可以继续使用流式输出吗?答:可以。RelayRouter 支持 streaming,用法与原 OpenAI SDK 一致。