Claude Messages API — POST /v1/messages 完整参考

端点

POST https://api3.claudestore.store/v1/messages

Headers:
  x-api-key: sk-cs2-...
  anthropic-version: 2023-06-01
  content-type: application/json

请求体参数

• model — 模型 ID，如 claude-sonnet-4.6
• max_tokens — 输出最大 Token 数（必填）
• messages — 对话数组，元素含 role 与 content
• system — 系统提示（字符串或 content blocks）
• temperature — 0.0–1.0，默认 1.0
• top_p, top_k — 采样控制
• stream — 是否流式输出 (SSE)
• tools — 工具调用定义
• cache_control — Prompt Caching 控制

完整示例

curl https://api3.claudestore.store/v1/messages \
  -H "x-api-key: sk-cs2-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4.6",
    "max_tokens": 1024,
    "system": "你是一个专业的中文翻译助手。",
    "messages": [
      {"role": "user", "content": "把这句话翻译成英语：今天天气真好"},
      {"role": "assistant", "content": "What lovely weather we have today."},
      {"role": "user", "content": "再翻译成法语"}
    ]
  }'

响应格式

{
  "id": "msg_01...",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4.6",
  "content": [
    {"type": "text", "text": "Quel beau temps aujourd'hui."}
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 45,
    "output_tokens": 12
  }
}