开发接入 · Node SDK

openai Node SDK:baseURL 与 base_url 的区别

JS SDK 的参数名是 baseURL(驼峰),不是 Python 的 base_url。这个大小写差异是新手最常见的报错来源。

安装

安装bash
npm i openai
chat.mjsjavascript
import OpenAI from "openai";

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

const resp = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);

流式

stream.mjsjavascript
const stream = await client.chat.completions.create({
  model: "gpt-5.5", messages, stream: true,
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

常见坑

  • 写成 base_url 会被忽略,请求仍打到官方域名,表现为 401;
  • Next.js 的 Edge Runtime 不支持 Node 原生 fetch 的部分特性,遇到奇怪错误先换 Node runtime;
  • 浏览器端直接使用 SDK 会暴露密钥,必须走自己的后端。

常见问题

Node SDK 的 baseURL 要带 /v1 吗?

要,写成 https://hardysapi.com/v1;SDK 会拼接 /chat/completions。

为什么设置了 baseURL 还是 401?

检查字段名是否写成了 base_url(Python 的写法),JS SDK 只认 baseURL。