OpenAI Node.js SDK 自定义 Base URL

安装并配置客户端

npm install openai
export OPENAI_API_KEY="YOUR_KEY"

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: "https://monkeytheme.com/v1",
});

先检查 Key 和准确的 Model ID

写生成代码前先查询模型列表。请使用自己的 Key 返回的模型 ID，不要照抄截图里的名称。

const models = await client.models.list();
for (const model of models.data) console.log(model.id);

2026 年 8 月 3 日，生产环境的未认证检查显示，/v1/models、/v1/responses 和 /v1/chat/completions 都返回结构化的 401 API_KEY_REQUIRED。这只能证明路由已到达认证层，不能证明认证后的模型和功能可用。

发送一条最小 Responses 请求

const response = await client.responses.create({
  model: "MODEL_ID_FROM_LIST",
  input: "Reply with OK",
  max_output_tokens: 16,
  store: false,
});

console.log(response.output_text);
console.log("request_id", response._request_id);

OpenAI 建议新项目优先使用 Responses。兼容网关对具体接口的支持仍可能不同，因此应先跑通最小请求，再增加工具、流式响应或会话状态。

Chat Completions 的响应结构不同

const completion = await client.chat.completions.create({
  model: "MODEL_ID_FROM_LIST",
  messages: [{ role: "user", content: "Reply with OK" }],
  max_completion_tokens: 16,
});

console.log(completion.choices[0].message.content);
console.log("request_id", completion._request_id);

不能只替换接口路径。Responses 使用 input 和带类型的 output items；Chat Completions 使用 messages 和 choices。迁移现有客户端前，请先看 两种接口的对比。

超时、重试和错误日志

const client = new OpenAI({
  apiKey: process.env.OPENAI_API_KEY,
  baseURL: "https://monkeytheme.com/v1",
  timeout: 30_000,
  maxRetries: 2,
});

try {
  // 在这里发请求
} catch (err) {
  console.error({
    name: err.name,
    status: err.status,
    request_id: err.request_id,
    message: err.message,
  });
}

官方 SDK 的客户端超时默认是 10 分钟，并会对连接错误、408、409、429 和 5xx 响应重试两次。反向代理可能更早超时。不要直接把所有时限调大，还应避免外层重试循环把请求次数成倍放大。

常见配置错误

官方资料与相关教程

• openai-node 官方 README：构造参数、Responses、Chat Completions、重试、超时和请求 ID。
• API Base URL 与 /v1
• API Key 与模型排错
• API 504 超时排错

常见问题