首页/AI/AI 应用速查/Anthropic Messages API

Anthropic Messages API

Claude 的官方接口:POST https://api.anthropic.com/v1/messages,system 为顶层参数,max_tokens 必填,流式返回按事件类型(message_start、content_block_delta 等)。

AI 应用速查AI更新于 2026-10-12
路径/v1/messages
鉴权x-api-key + anthropic-version: 2023-06-01
必填model、max_tokens、messages
结构system 顶层;回复在 content 数组

最小调用(curl)

最小调用(curl)
curl -s https://api.anthropic.com/v1/messages -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01" -H "Content-Type: application/json" -d '{"model":"claude-sonnet-4-5","max_tokens":1024,"messages":[{"role":"user","content":"你好"}]}'
流式响应是丰富事件流(含内容块增量与用量统计),客户端应按事件类型解析,不要只盯着 delta 文本。

易错点

  • 漏传 max_tokens(必填字段,直接 400)
  • 把 system 作为 messages 角色传入(应作为顶层参数)

数据来源与参考

  • Anthropic Messages API 文档

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌