用七个步骤为 Node.js SDK 配置替代端点
把模型请求切换到替代端点，不应只是替换一个网址。你还需要确认鉴权、请求路径、模型标识与错误处理。CodeRelay Hub 提供按量付费的统一入口；下面以 OpenAI 的 Node.js SDK 为例，把接入过程拆成七个可验证的步骤。
一、准备独立的测试环境
先在测试项目中安装依赖，执行 npm install openai，并把锁文件提交到版本控制。官方 SDK 提供 JavaScript 与 TypeScript 接口，安装包名为 openai。([github.com](https://github.com/openai/openai-node?country=8&utm_source=openai))
不要直接修改生产服务的公共客户端。先建立一个只发送短消息的测试入口，把网络连通性、鉴权和业务逻辑分开验证。为测试设置明确的用量边界，避免调试循环持续产生请求。
二、把密钥与地址放进环境变量
建议分别设置 CODERELAY_API_KEY、CODERELAY_BASE_URL 和 CODERELAY_MODEL。地址填写 https://api.coderelayhub.com，模型变量填写平台实际接受的模型标识，不要把展示名称自行转换成接口参数。
密钥通过部署平台的秘密管理功能注入，不要放进源码、浏览器脚本或日志。示例统一使用自定义变量名，让同一进程里的其他客户端不必跟着切换。启动时检查三个变量是否存在，缺失时直接报错，而不是意外回退到其他端点。
三、显式初始化客户端
官方 SDK 支持通过 baseURL 覆盖默认地址，并通过 apiKey 设置密钥。([github.com](https://github.com/openai/openai-node?country=8&utm_source=openai))
在使用模块语法的服务端文件中，先导入客户端，再集中创建实例：
import OpenAI from 'openai';
const client = new OpenAI({ apiKey: process.env.CODERELAY_API_KEY, baseURL: process.env.CODERELAY_BASE_URL, timeout: 30000, maxRetries: 0 });
这里的三十秒与关闭重试都是接入阶段的示例设置，不是平台性能承诺。把实例创建集中在一个模块，业务代码只导入该实例，后续切换环境时就不必逐个修改调用位置。
四、核对路径，不要猜测版本前缀
SDK 的聊天补全调用使用 client.chat.completions.create(...)。([github.com](https://github.com/openai/openai-node?country=8&utm_source=openai))
配置地址时，区分服务入口、接口前缀与具体资源路径。不要把完整的聊天补全地址直接当作基础地址，也不要因为其他服务使用版本前缀，就自行追加同样的内容。若出现路径错误，先对照平台接入说明确认是否需要额外前缀，并检查最终请求地址有没有重复路径。
先确认平台支持准备使用的接口，再决定调用方法。不要把某个接口能够返回结果，视为所有接口与参数都已经兼容。
五、发送最小请求并检查结果
第一次请求只保留模型和消息，暂时不加入工具调用、结构化输出或其他可选参数：
const result = await client.chat.completions.create({ model: process.env.CODERELAY_MODEL, messages: [{ role: 'user', content: '请只回复：连接成功。' }] });
聊天补全示例可以从 result.choices[0]?.message?.content 读取文本。([github.com](https://github.com/openai/openai-node?country=8&utm_source=openai))
检查响应是否符合预期，而不只是确认请求没有抛出异常。如果你准备使用 Gemini 2.5 Flash，仍应从平台复制其实际模型标识。最小请求通过后，每次只增加一项能力，便于定位是哪一个参数引入了问题。
六、按故障类型排查并设置重试
官方 SDK 会默认重试部分连接错误及特定状态码，也允许使用 maxRetries 调整重试次数。([github.com](https://github.com/openai/openai-node?country=8&utm_source=openai))
- 鉴权失败：检查变量是否注入正确、密钥是否有效，以及是否误用了其他服务的密钥。
- 资源不存在：分别核对基础地址、接口路径和模型标识，不要一次同时修改三项配置。
- 限流或服务异常：记录状态码，降低测试并发，再根据业务时限制定退避策略。
- 请求超时：区分连接失败与生成等待，避免立即重复提交同一项业务任务。
如果业务层已经重试，先计算它与 SDK 重试叠加后的最大尝试次数。尤其是会触发外部操作的流程，应先设计幂等控制，再增加自动重试。
七、完成上线前检查
上线前，把普通请求、无效密钥、错误模型标识、超时和流式中断分别列成测试用例。日志建议记录业务追踪标识、模型、耗时、状态码和可用的请求标识；不要默认记录完整提示词、响应内容或鉴权头。
将地址、模型与重试策略作为可回滚配置发布，并准备恢复原配置的操作步骤。验证重点不是“成功返回过一次”，而是失败时能定位原因、控制重复请求，并在不暴露秘密的情况下恢复服务。
现在就开通 CodeRelay Hub 的免费工作区。