#Anthropic Messages 接口

文档版本: v1.0 | 更新日期: 2026-10-14

#1. 接口概述

Messages 接口兼容 Anthropic Messages API 协议，适合只能配置 Anthropic 协议的工具（如 Claude Code）。用它就能以 Anthropic 的请求格式调用平台上的模型。

⚠️ 平台不提供 Claude 模型。请把 model 设为平台实际支持的模型（如 deepseek-v4.1-flash），而不是 claude-*。

#2. 请求头

x-api-key: sk-你的API-Key
anthropic-version: 2023-06-01
Content-Type: application/json

也支持用 Authorization: Bearer sk-你的API-Key 代替 x-api-key，两者效果一致。

#3. 请求参数（常用）

#4. 调用示例

curl：

curl -X POST https://api.sapis.cn/v1/messages \
  -H "x-api-key: sk-你的API-Key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "max_tokens": 256,
    "messages": [{ "role": "user", "content": "用一句话介绍你自己" }]
  }'

Python（Anthropic SDK）：

from anthropic import Anthropic

client = Anthropic(api_key="sk-你的API-Key", base_url="https://api.sapis.cn")
msg = client.messages.create(
    model="deepseek-v4.1-flash",
    max_tokens=256,
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(msg.content[0].text)

#5. 返回结构

type 为 message，内容在 content[]（可能含 thinking 与 text），结束原因在 stop_reason：

{
  "type": "message",
  "role": "assistant",
  "content": [
    { "type": "thinking", "thinking": "..." },
    { "type": "text", "text": "hi" }
  ],
  "stop_reason": "end_turn",
  "model": "deepseek/deepseek-v4.1-flash",
  "usage": { "input_tokens": 35, "output_tokens": 15 }
}

#6. 流式输出

设置 stream: true 后返回 SSE，事件为标准 Anthropic 事件，例如：

event: message_start
data: {"type":"message_start","message":{"type":"message","role":"assistant","content":[]}}

event: content_block_start
data: {"type":"content_block_start","index":0,"content_block":{"type":"thinking","thinking":""}}

#7. 常见问题

Q：Claude Code 这类工具怎么接？ 把工具里的 ANTHROPIC_BASE_URL 设为 https://api.sapis.cn（不带 /v1），ANTHROPIC_AUTH_TOKEN 设为你的 Key，并把模型改成平台支持的模型。详见 Claude Code 教程。

Q：max_tokens 必填吗？ 是。Anthropic 协议要求提供 max_tokens，否则请求会报错。