跳转到主要内容
POST
/
v1
/
messages
Claude messages
curl --request POST \
  --url http://sandbox.mintlify.com/v1/messages \
  --header 'Content-Type: application/json' \
  --header 'anthropic-version: <anthropic-version>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "model": "claude-sonnet-4-5",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "请总结这张图片里的关键信息"
        }
      ]
    }
  ]
}
'
{
  "id": "msg_01ABCxyz",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-5",
  "content": [
    {
      "type": "text",
      "text": "图片中是一张产品宣传海报。"
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 128,
    "output_tokens": 48
  }
}
适合 Claude 原生消息格式、多轮上下文、视觉输入和工具调用。
  • 使用 x-api-keyanthropic-version 请求头
  • system 是顶层字段,不属于 messages[]
  • messages[].content 是 block 结构,不建议提前扁平化成单字符串
  • 如果要启用工具调用,需要显式传入 tools,并在后续轮次回传 tool_result

授权

x-api-key
string
header
必填

请求头

anthropic-version
string
必填

Anthropic API version header.

示例:

"2023-06-01"

请求体

application/json
model
string
必填
示例:

"claude-sonnet-4-5"

max_tokens
integer
必填
messages
object[]
必填
system
tools
object[]
stream
boolean

响应

Successful Claude message response

id
string
type
enum<string>
可用选项:
message
role
enum<string>
可用选项:
assistant
model
string
content
object[]
stop_reason
string
stop_sequence
string
usage
object