目录 · 7 个章节
一句话:openai 包的 baseURL 要带 /v1,@anthropic-ai/sdk 不带,@google/genai 也不带。 填反了就是 404,或者 /v1/v1/...。
Node 项目接第三方模型接口,最常见的坑就是地址填错,这里记一下。下面的示例地址用的是我在维护文档的一个站,换成你自己用的官方地址、公司网关或者别的兼容服务都一样。
三个 SDK 的填法
| npm 包 | 构造参数 | 地址怎么填 | SDK 自己拼的路径 |
|---|---|---|---|
openai | baseURL | https://域名/v1 | /chat/completions、/responses |
@anthropic-ai/sdk | baseURL | https://域名 | /v1/messages |
@google/genai | httpOptions.baseUrl | https://域名 | /v1beta/models/... |
规律就一条:看 SDK 自己拼的路径里有没有 /v1。有的就别再写,没有的你得自己补上。
1. openai 包
npm i openai
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.MY_LLM_KEY, // 不写这一行时 SDK 会自动读 OPENAI_API_KEY
baseURL: "https://api.niceai.dev/v1", // 要带 /v1
});
const res = await client.chat.completions.create({
model: "填服务商模型列表里的名字",
messages: [{ role: "user", content: "你好" }],
});
console.log(res.choices[0].message.content);
不想改代码的话,openai 包也会读环境变量 OPENAI_BASE_URL,值一样要带 /v1。
流式输出:
const chunks = await client.chat.completions.create({
model: "填服务商模型列表里的名字",
messages: [{ role: "user", content: "写一首短诗" }],
stream: true,
});
for await (const chunk of chunks) {
process.stdout.write(chunk.choices[0]?.delta?.content || "");
}
2. @anthropic-ai/sdk
npm i @anthropic-ai/sdk
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
apiKey: process.env.ANTHROPIC_API_KEY,
baseURL: "https://api.niceai.dev", // 不带 /v1
});
const msg = await client.messages.create({
model: "填服务商模型列表里的名字",
max_tokens: 512,
messages: [{ role: "user", content: "你好" }],
});
console.log(msg.content[0].text);
环境变量是 ANTHROPIC_BASE_URL,同样不带 /v1。Claude Code 也读这个变量,所以两边用同一个值就行。
有的服务要求用 Authorization: Bearer 而不是 x-api-key,这时把 apiKey 换成 authToken 即可。
3. @google/genai
npm i @google/genai
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({
apiKey: process.env.GEMINI_API_KEY,
httpOptions: { baseUrl: "https://api.niceai.dev" }, // 不带 /v1beta
});
const r = await ai.models.generateContent({
model: "填服务商模型列表里的名字",
contents: "你好",
});
console.log(r.text);
怎么确认地址填对了
先别跑业务代码,用 curl 打一次:
# OpenAI 格式
curl -sS -w '\n%{http_code}\n' https://api.niceai.dev/v1/models \
-H "Authorization: Bearer $MY_LLM_KEY"
- 返回 JSON 模型列表:地址和密钥都对。
- 返回 HTML 或 404:地址错了。
- 返回 JSON 格式的 401:地址对,密钥错。
常见报错对照
| 报错 | 原因 | 改法 |
|---|---|---|
404 Not Found,URL 里是 /v1/v1/messages | Anthropic SDK 的 baseURL 多写了 /v1 | 去掉 /v1 |
404 Not Found,URL 是 /chat/completions 前面没有 /v1 这一段 | 这是 baseURL 少写了 /v1 | 补上 /v1 |
SyntaxError: Unexpected token '<' | 返回的是 HTML 页面,不是 JSON,基本是地址错了或者被网关拦了 | 用上面的 curl 看实际返回 |
401 | 密钥不对、前后多了空格 | 重新复制密钥 |
403 | 密钥对,但没余额或没这个模型的权限 | 查余额和分组 |
400 model not found | 模型名不对 | 按服务商模型列表核对 |
429 | 请求太快 | 降并发;两个 SDK 默认都会重试 2 次,别再自己套一层大量重试 |
流式输出到一半断了,ECONNRESET / terminated | 中间代理或负载均衡超时 | 先用 curl 加 -N 测流式;自己有 Nginx 的话把 proxy_buffering off 和超时调大 |
FAQ
为什么 openai 要带 /v1,Anthropic 不带?
两家 SDK 设计不同。openai 包默认地址本身就是 https://api.openai.com/v1,拼接时只加 /chat/completions;Anthropic SDK 默认地址是 https://api.anthropic.com,拼接时加的是 /v1/messages。
环境变量和构造参数都写了,听谁的? 构造参数优先。排查时最好只留一处,免得改了一个忘了另一个。
Cursor、Cline 这些编辑器插件呢?
基本都是 OpenAI 格式,填 https://域名/v1。Claude Code 是 Anthropic 格式,填根域名。
Node 版本有要求吗? 这几个 SDK 都用的是原生 fetch,建议 Node 18 以上。
示例里的 api.niceai.dev 是我参与的 NiceAI,各客户端的地址规则整理在 https://wiki.niceai.dev/guide/tech/base-url-rules 。