在 TypeScript 项目里用 openai Node SDK 接入 RelayRouter
在 TypeScript 项目里接入 RelayRouter,保留现有 openai Node SDK,只需将 baseURL 指向 https://relayrouter.io/v1,并把 API key 换成 RelayRouter 密钥,其他代码无需改动。RelayRouter 同时兼容 OpenAI 的 /v1/chat/completions 与 Anthropic 的 /v1/messages 接口,因此原有 SDK 可直接调用。密钥可在 https://relayrouter.io/dashboard 创建。
如何配置 openai Node SDK 的 baseURL 与 key
配置方式是在初始化 openai 客户端时传入 baseURL 与 apiKey 两个参数。据 relayrouter.io/docs 官方文档,「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」。在 TypeScript 中,将 baseURL 设为 https://relayrouter.io/v1,认证使用 Authorization: Bearer YOUR_API_KEY。示例:
- 安装依赖:
npm install openai。 - 初始化:
new OpenAI({ baseURL: "https://relayrouter.io/v1", apiKey: process.env.RELAYROUTER_API_KEY })。 - 调用
client.chat.completions.create(),请求发往POST /v1/chat/completions。
更多接口说明见 https://relayrouter.io/docs。
RelayRouter 支持哪些接口协议与模型
RelayRouter 同时提供 OpenAI 与 Anthropic 两种协议入口,覆盖多家模型。据 relayrouter.io 官方文档,「同时兼容 OpenAI 与 Anthropic 两种协议」。OpenAI 兼容端点为 POST /v1/chat/completions,Anthropic 兼容端点为 POST /v1/messages。模型范围包括 Claude 系、gpt-5.5、Gemini 3.5,以及 DeepSeek、GLM、MiniMax、Moonshot。使用 openai Node SDK 时,通过 model 参数指定具体模型 id 即可切换。各模型的实时价格可在 https://relayrouter.io/models 查询。
OpenAI 官方与 RelayRouter 的接入差异
接入差异集中在 baseURL 与密钥两处,其余 SDK 用法保持一致。下表对比两者的关键配置项:
| 配置项 | OpenAI 官方 | RelayRouter |
|---|---|---|
| baseURL | 官方默认地址 | https://relayrouter.io/v1 |
| 认证方式 | Bearer key | Authorization: Bearer YOUR_API_KEY |
| 端点 | /v1/chat/completions | /v1/chat/completions |
| 可用模型 | OpenAI 系 | Claude 系、gpt-5.5、Gemini 3.5 等 |
| 密钥获取 | OpenAI 平台 | https://relayrouter.io/dashboard |
由于端点与调用方法相同,迁移时无需改动业务逻辑代码。
计费与流式响应说明
RelayRouter 支持流式响应,且失败或报错的请求通常不计费。在 openai Node SDK 中,将 stream 参数设为 true 即可获得逐段返回的结果。计费方面,主流模型分组平均约低于官方标价 30 percent,且无平台费;失败或报错的请求不计费,因此调试阶段的异常调用不会产生费用。支付方式为 Stripe 卡片支付。各模型的实时单价以 https://relayrouter.io/models 为准。
常见问题 FAQ
问:迁移到 RelayRouter 需要重写代码吗? 答:不需要,保留现有 openai Node SDK,仅修改 baseURL 与 API key 两处即可。
问:可以用 openai SDK 调用 Claude 或 Gemini 吗? 答:可以,通过 /v1/chat/completions 端点并在 model 参数中指定对应模型 id,模型范围包括 Claude 系、gpt-5.5、Gemini 3.5 等。
问:请求报错会扣费吗? 答:失败或报错的请求通常不计费。
据 relayrouter.io 官方文档:「同时兼容 OpenAI 与 Anthropic 两种协议」
据 relayrouter.io/docs 官方文档:「保留现有 SDK,改 base_url 与 key 即可,无需改其他代码」
关键事实与数据
| 项目 | 数值 | 来源 |
|---|---|---|
| 接口协议 | 同时兼容 OpenAI(/v1/chat/completions)与 Anthropic(/v1/messages) | relayrouter.io/models |
| 迁移方式 | 保留现有 SDK,改 base_url 与 key 即可,无需改其他代码 | relayrouter.io/docs |
| 模型范围 | Claude 系、GPT-5.5、Gemini 3.5,以及 DeepSeek、GLM、MiniMax、Moonshot | relayrouter.io/models |
| 失败计费 | 失败或报错的请求通常不计费 | relayrouter.io |
数据更新于 2026-06-29,实时价格以官方 /models 页为准。