Claude
Claude Opus 5 · Messages
文本 / Claude / Claude Opus 5 / Messages
POST
/v1/messages请求参数
Authorization
在 Header 添加参数 Authorization，其值为 Bearer 之后拼接你的 API Key。
Authorization: Bearer ****************
anthropic-version: 2023-06-01
Header 参数
Content-Typestring可选
application/json
Acceptstring可选
application/json
Body 参数application/json必填
modelstring必需
模型 ID，固定为 `claude-opus-5`
messagesarray[object]必需
对话消息列表；每条含 `role`（user / assistant）与 `content`（文本或内容块）
max_tokensinteger必需
最大生成 token 数；Anthropic API 必填
systemstring | array[object]可选
系统提示词，作为顶层字段传入（不放进 messages）
temperaturenumber可选
采样温度，越高越随机
top_pnumber可选
核采样，与 `temperature` 二选一。范围 `0`–`1`
top_kinteger可选
Top-k 采样，仅从概率最高的 K 个 token 中选择
streamboolean可选
是否流式返回（SSE），默认 `false`
stop_sequencesarray[string]可选
自定义停止序列，命中即停止生成
toolsarray[object]可选
工具定义，用于工具调用
tool_choiceobject可选
控制是否及使用哪个工具
metadataobject可选
请求元信息，如 `user_id`
thinkingobject可选
思考配置；支持方式取决于具体 Claude 模型
示例
{ "model": "claude-opus-5", "max_tokens": 1024, "messages": [ { "role": "user", "content": "你好，介绍一下你自己" } ]}请求示例代码
curl https://api.hotrouter.ai/v1/messages \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model": "claude-opus-5", "max_tokens": 1024, "messages": [ { "role": "user", "content": "你好，介绍一下你自己" } ] }'返回响应
200 · 成功
idstring必需
本次响应的唯一 id
typestring必需
对象类型（message）
rolestring必需
消息角色
contentarray[object]必需
内容块数组
stop_reasonstring可选
结束原因（end_turn / max_tokens 等）
usageobject必需
本次调用的 token 用量
示例
{ "id": "msg_xxx", "type": "message", "role": "assistant", "content": [ { "type": "text", "text": "你好！很高兴见到你……" } ], "stop_reason": "end_turn", "usage": { "input_tokens": 12, "output_tokens": 24 }}