跳到主要内容
CNode

Node.js 里用 OpenAI / Anthropic SDK 接第三方 API 地址,baseURL 到底带不带 /v1?

分享
Nniceaidev发布于 21 小时前
0700
目录 · 7 个章节

一句话:openai 包的 baseURL 要带 /v1,@anthropic-ai/sdk 不带,@google/genai 也不带。 填反了就是 404,或者 /v1/v1/...。

Node 项目接第三方模型接口,最常见的坑就是地址填错,这里记一下。下面的示例地址用的是我在维护文档的一个站,换成你自己用的官方地址、公司网关或者别的兼容服务都一样。

三个 SDK 的填法

npm 包构造参数地址怎么填SDK 自己拼的路径
openaibaseURLhttps://域名/v1/chat/completions、/responses
@anthropic-ai/sdkbaseURLhttps://域名/v1/messages
@google/genaihttpOptions.baseUrlhttps://域名/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/messagesAnthropic 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 。

查看回复

回复 (0)

暂无回复,成为第一个参与讨论的人。

参与回复

登录后即可参与回复。登录