Anthropic API

兼容 Anthropic Messages API 格式，适用于 Claude Code、Anthropic SDK 等客户端。

端点

POST https://token.pudbot.com/v1/messages

请求头

Header	必填	说明
x-api-key	是	PudBot API Key
content-type	是	application/json
anthropic-version	是	2023-06-01

请求参数

参数	类型	必填	说明
model	string	是	模型名称，如 claude-sonnet-5
messages	array	是	消息数组，参见下方格式
max_tokens	integer	是	最大生成 Token 数
system	string	否	系统提示词
temperature	float	否	采样温度，0~1，默认 1.0
top_p	float	否	核采样，0~1
top_k	integer	否	Top-K 采样
stream	boolean	否	是否流式返回，默认 false
stop_sequences	array	否	停止序列

messages 格式

[
  {"role": "user", "content": "你好"},
  {"role": "assistant", "content": "你好！有什么可以帮你的？"},
  {"role": "user", "content": "写一首诗"}
]

content 可以是字符串，也可以是内容块数组：

{
  "role": "user",
  "content": [
    {"type": "text", "text": "这张图是什么？"},
    {"type": "image", "source": {"type": "base64", "media_type": "image/png", "data": "..."}}
  ]
}

请求示例

curl https://token.pudbot.com/v1/messages \
  -H "x-api-key: *** Key" \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

响应格式

{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello! How can I help you today?"
    }
  ],
  "model": "claude-sonnet-5",
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 10,
    "output_tokens": 15,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}

流式响应

设置 "stream": true，返回 SSE 事件流：

curl https://token.pudbot.com/v1/messages \
  -H "x-api-key: *** Key" \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "stream": true,
    "messages": [{"role": "user", "content": "写一首关于编程的诗"}]
  }'

主要事件类型：

事件	说明
message_start	消息开始
content_block_start	内容块开始
content_block_delta	内容增量（流式文本）
content_block_stop	内容块结束
message_delta	消息增量（含 stop_reason）
message_stop	消息结束

支持的模型

模型	说明
claude-haiku-4-5	快速响应，轻量任务
claude-sonnet-5	均衡性能，日常首选
claude-sonnet-4-6	Sonnet 4 系列
claude-sonnet-4-5	Sonnet 4 系列
claude-opus-4-8	Opus 4 系列，强推理
claude-opus-4-7	Opus 4 系列
claude-opus-4-6	Opus 4 系列
claude-opus-4-5	Opus 4 系列
claude-opus-5	最新 Opus，最强推理
claude-fable-5	Fable 系列