Skip to content

Anthropic Messages 接口 ​

调用 Claude 原生接口时,请求 POST https://api.niceai.dev/v1/messages,请求头带上 x-api-key 和 anthropic-version,请求体必须包含 model、max_tokens 和 messages。使用 SDK 时 Base URL 只填 https://api.niceai.dev。

请求示例 ​

bash
curl https://api.niceai.dev/v1/messages \
  -H "x-api-key: $NICEAI_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<模型名,见模型广场>",
    "max_tokens": 1024,
    "system": "你是一个简洁的助手。",
    "messages": [{"role": "user", "content": "你好"}]
  }'
python
import os
import anthropic

client = anthropic.Anthropic(base_url="https://api.niceai.dev", api_key=os.environ["NICEAI_API_KEY"])

msg = client.messages.create(
    model="<模型名,见模型广场>",
    max_tokens=1024,
    system="你是一个简洁的助手。",
    messages=[{"role": "user", "content": "你好"}],
)
print(msg.content[0].text)
ts
import Anthropic from '@anthropic-ai/sdk'

const client = new Anthropic({ baseURL: 'https://api.niceai.dev', apiKey: process.env.NICEAI_API_KEY })

const msg = await client.messages.create({
  model: '<模型名,见模型广场>',
  max_tokens: 1024,
  system: '你是一个简洁的助手。',
  messages: [{ role: 'user', content: '你好' }],
})
console.log(msg.content)

请求头 ​

请求头说明
x-api-keyNiceAI 密钥。Claude Code 用 ANTHROPIC_AUTH_TOKEN 时发送的是 Authorization: Bearer,两种写法都可以
anthropic-version接口版本,目前填 2023-06-01
anthropic-beta可选,开启测试中的功能,是否可用取决于上游

常用参数 ​

参数说明
model必填。模型名以 模型广场 为准
max_tokens必填。最大输出 token 数
messages必填。user 与 assistant 交替的对话历史
system系统提示词,放在顶层而不是 messages 里
stream设为 true 时流式返回,见 流式输出
tools工具定义,见 工具调用
thinking扩展思考,例如 {"type": "enabled", "budget_tokens": 2048},需模型支持
cache_control写在内容块上,开启提示词缓存,见 提示词缓存是怎么省钱的

和 Chat Completions 的主要区别 ​

Anthropic MessagesOpenAI Chat Completions
系统提示顶层 system 字段messages 里 role: system
输出上限max_tokens 必填可选
回复内容content 是内容块数组choices[0].message.content 字符串
用量字段usage.input_tokens / output_tokens,另有缓存读写字段usage.prompt_tokens / completion_tokens

常见问题 ​

返回 404? ​

SDK 的 Base URL 不要加 /v1;直接用 curl 时完整路径才是 /v1/messages。

返回 401? ​

确认密钥分组为 Claude,并且只设置了一种鉴权方式。

返回 400 提示缺少 max_tokens? ​

Messages 接口必须传 max_tokens。

下一步 ​

NiceAI · 稳定的 AI 大模型 API 中转站