Node.js OpenAI SDK 自定义 baseURL：兼容 Endpoint 配置与请求验证

最后验证：2026-08-31 · FXXT技术栈编辑部

Node.js 客户端的 baseURL 应只配置服务商公开的兼容 API 根路径。先用一条最小请求确认实际目标、认证与模型名，避免把完整资源路径重复拼入根地址。

Quick diagnosis

遇到 401、404 或模型不存在时，分别检查 API Key 来源、baseURL 的版本前缀和模型名。打印配置时只输出脱敏后的 URL，绝不输出 Authorization 或密钥。

Code example

import OpenAI from "openai";
const client = new OpenAI({
  apiKey: "YOUR_API_KEY",
  baseURL: "https://router.xisu.ai/v1",
});
const response = await client.chat.completions.create({
  model: "YOUR_MODEL",
  messages: [{ role: "user", content: "ping" }],
});

Why it happens

常见问题是环境变量覆盖了初始化参数、根 URL 缺少版本路径，或将 /chat/completions 误写进根地址。代理环境也可能让请求离开预期网络路径。

Verification

先用 SDK 最小请求，再使用 curl 对同一主机验证 DNS、TLS 与状态码。确认无误后才接入业务流量；失败则恢复原 baseURL 与环境变量。

Implementation Example

犀速Ai当前公开页面说明兼容 OpenAI 接口，并展示兼容客户端的根地址示例。只有在你已核对当日公开资料、模型列表与访问权限时，才将其作为犀速Ai开发者资源使用。

Common mistakes

不要把真实 Key 提交到 Git；不要假定所有兼容 API 支持相同参数；切换 endpoint 后应重新验证流式、超时与错误处理。

Related Runbooks

Python OpenAI SDK 自定义 base_url · OpenAI SDK APITimeoutError · Nginx SSE buffering