Claude
Claude Sonnet 5 · Messages
文本 / Claude / Claude Sonnet 5 / 对话补全
接口
POST /v1/messages
Content-Type: application/json
Authorization: Bearer $API_KEY
anthropic-version: 2023-06-01
原生 Anthropic Messages 端点，支持多轮对话、system 提示词与流式输出。
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型 ID，固定为 claude-sonnet-5 |
messages | array | 是 | 对话消息列表；每条含 role（user / assistant）与 content（文本或内容块） |
max_tokens | int | 是 | 最大生成 token 数；Anthropic API 必填 |
system | string | 否 | 系统提示词，作为顶层字段传入（不放进 messages） |
stream | bool | 否 | 是否流式返回（SSE），默认 false |
temperature | number | 否 | 采样温度，越高越随机 |
top_p | number | 否 | 核采样，与 temperature 二选一。范围 0–1 |
stop_sequences | array | 否 | 自定义停止序列，命中即停止生成 |
tools | array | 否 | 工具定义，用于工具调用（function calling） |
tool_choice | object | 否 | 是否及使用哪个工具：auto / any / tool |
示例
curl https://api.beerouter.ai/v1/messages \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-H "anthropic-version: 2023-06-01" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 1024,
"messages": [
{ "role": "user", "content": "你好，介绍一下你自己" }
]
}'
流式
将 stream 设为 true，响应以 Anthropic SSE 事件返回（message_start、content_block_delta、message_stop）。
响应
{
"id": "msg_xxx",
"type": "message",
"role": "assistant",
"model": "claude-sonnet-5",
"content": [
{ "type": "text", "text": "你好！很高兴见到你……" }
],
"stop_reason": "end_turn",
"usage": { "input_tokens": 12, "output_tokens": 24 }
}