Anthropic 兼容接口
用 Anthropic 官方 SDK 或 Messages 格式调用 Claude 模型:Base URL、鉴权方式、流式输出与常见问题。
更新于 2026-11-16
TokenDuo 提供与 Anthropic Messages API 格式兼容的接口。Anthropic 官方 SDK(Python、TypeScript 等),以及 Claude Code 这类基于 Anthropic 格式的工具,只需修改 Base URL 和 API 密钥即可使用。
只有详情页「端点」中包含
anthropic的模型才支持本格式。可用模型以「模型与价格」页面为准。
Base URL
https://niul-ai.cn
- SDK 会自动在后面拼接
/v1/messages,所以 Base URL 不要加/v1。 - 直接发 HTTP 请求时,完整地址是
https://niul-ai.cn/v1/messages。
鉴权
两种请求头都可以,任选其一:
x-api-key: sk-xxxx(Anthropic SDK 的默认方式)Authorization: Bearer sk-xxxx
API 密钥在控制台「API 密钥」页面创建,见「API 密钥管理」。
发送请求
curl https://niul-ai.cn/v1/messages \
-H "x-api-key: sk-xxxx" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "Claude 模型名称",
"max_tokens": 1024,
"messages": [
{"role": "user", "content": "用一句话介绍你自己"}
]
}'
Python SDK
import anthropic
client = anthropic.Anthropic(base_url="https://niul-ai.cn", api_key="sk-xxxx")
message = client.messages.create(
model="Claude 模型名称",
max_tokens=1024,
messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(message.content[0].text)
TypeScript / Node.js SDK
import Anthropic from '@anthropic-ai/sdk'
const client = new Anthropic({
baseURL: 'https://niul-ai.cn',
apiKey: process.env.TOKEN_DUO_API_KEY,
})
const message = await client.messages.create({
model: 'Claude 模型名称',
max_tokens: 1024,
messages: [{ role: 'user', content: '用一句话介绍你自己' }],
})
console.log(message.content)
也可以不在代码里写地址和密钥:设置环境变量 ANTHROPIC_BASE_URL=https://niul-ai.cn 和 ANTHROPIC_API_KEY=sk-xxxx,官方 SDK 会自动读取。
流式输出
在请求中加入 "stream": true,响应会以 SSE(Server-Sent Events)的形式逐段返回。用 Python SDK 时:
with client.messages.stream(
model="Claude 模型名称",
max_tokens=1024,
messages=[{"role": "user", "content": "写一首关于秋天的短诗"}],
) as stream:
for text in stream.text_stream:
print(text, end="")
常见问题
返回 404 或找不到接口:检查 Base URL 是否多加了 /v1。SDK 会自己拼接 /v1/messages,Base URL 写成 https://niul-ai.cn/v1 会变成 /v1/v1/messages。
Anthropic 格式和 OpenAI 格式用哪个:使用 Anthropic SDK 或 Claude Code 时用本格式;使用 OpenAI SDK 或只支持 OpenAI 格式的客户端时,见「OpenAI 兼容接口」。同一个 API 密钥两种格式都能用。
在 Claude Code 中使用:见「Claude Code 接入」。
更多错误说明见「常见错误与排查」。