API 参考进阶用户更新于
POST/v1/messages
Anthropic Messages 消息接口
用 Anthropic Messages 格式发送消息。此页适用于直接发送 HTTP 请求，Claude Code 的设置步骤在相关指南中。
接入准备
按快速开始获取 API Key，并选择支持直接 HTTP 调用的接入点。示例通过 x-api-key 发送 ICODEEASY_API_KEY，并携带 anthropic-version。将 YOUR_MODEL_ID 换成所选接入点支持的模型 ID。
请求示例
model 指定模型，max_tokens 限制输出长度，messages 传入会话消息。
bash
curl -sS https://api.icodeeasy.cc/v1/messages \
-H "x-api-key: $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
-H 'anthropic-version: 2023-06-01' \
--data '{
"model": "YOUR_MODEL_ID",
"max_tokens": 256,
"messages": [
{
"role": "user",
"content": "Say hello."
}
]
}'
读取响应
遍历 content[]，读取 type 为 text 的块。从 usage.input_tokens 和 usage.output_tokens 读取用量。若返回 cache_creation_input_tokens 和 cache_read_input_tokens，分别表示缓存写入和读取。
json
{
"content": [
{
"type": "text",
"text": "Hello!"
}
],
"stop_reason": "end_turn"
}
流式响应示例
请求体设置 stream: true 开启 SSE。拼接 content_block_delta 里的 delta.text，用 message_delta 读取结束原因，用 message_stop 确认消息已结束。如果流内出现 error 事件，按失败处理，哪怕 HTTP 状态已经是 200。
text
event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"Hello!"}}
event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn","stop_sequence":null},"usage":{"output_tokens":4}}
event: message_stop
data: {"type":"message_stop"}
从 message_start.message.usage 和后续 message_delta.usage 读取流式用量。缓存字段的含义与 JSON 响应相同。