API 文档 · 对话模型

Anthropic 原生接口

POST /v1/messages：x-api-key 鉴权、事件流、usage 与错误格式。

POST https://cn-api.aitoken.tools/v1/messages 与 Anthropic Messages API 兼容，适合 anthropic SDK 与 Claude Code。只有能力表 formats 含 anthropic 的模型可以走这个接口。

鉴权与请求头

x-api-key: 平台 Key（也接受 Authorization: Bearer）。
anthropic-version 可以不传，平台固定用 2023-06-01 调用上游；anthropic-beta 原样转给上游。

请求字段

字段	说明
`model`	必填。本站的对话模型名
`max_tokens`	必填，正整数。也是本次冻结额度的输出上界
`messages`	必填，非空数组
`system、tools、stream、temperature…`	其他字段原样转给上游

流式

stream: true 时按 Anthropic 事件流返回（message_start、content_block_delta、message_delta、message_stop）。平台从 message_start 与 message_delta 里读取 usage 结算，事件本身原样转发（model 换成本站名）。

错误格式

错误体使用 Anthropic 格式 { "type": "error", "error": { "type", "message" } }。状态码含义与OpenAI 兼容接口相同，error.type 对应为 authentication_error、billing_error、permission_error、not_found_error、invalid_request_error、rate_limit_error、overloaded_error。缺少 max_tokens 时返回 422 invalid_request_error。Key 无效与超过 RPM 的错误同样是平台通用格式（见 OpenAI 兼容接口一节）。

curl https://cn-api.aitoken.tools/v1/messages \
  -H "x-api-key: $AITOKEN_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 1024,
    "messages": [{ "role": "user", "content": "Hello" }]
  }'