TokenDuo

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 接入」。

更多错误说明见「常见错误与排查」。

上一篇:OpenAI 兼容接口

下一篇:Claude Code 接入