POST
/
v1
/
messages
Claude Messages API
curl --request POST \
  --url https://vip.xmsmartlink.com/v1/messages \
  --header 'Content-Type: application/json' \
  --header 'anthropic-version: <anthropic-version>' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "model": "claude-3-5-sonnet-20240620",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Hello, Claude"
    }
  ]
}
'
{
  "id": "msg_xxx",
  "type": "message",
  "role": "assistant",
  "model": "claude-3-5-sonnet-20240620",
  "content": [
    {
      "type": "text",
      "text": "幂等性表示对同一资源重复执行同一操作,多次与一次的最终效果一致。"
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 18,
    "output_tokens": 26
  }
}

Authorizations

x-api-key
string
header
required

Claude 官方格式认证请求头。

Headers

anthropic-version
string
default:2023-06-01
required

Anthropic API 版本请求头。

Body

application/json
model
string
required

Claude 模型名称。

Example:

"claude-3-5-sonnet-20240620"

max_tokens
integer
required

最大输出 token 数。

Example:

1024

messages
object[]
required

消息数组(role/content)。

system

系统提示词(官方字段)。

temperature
number

采样温度。

top_p
number

nucleus sampling 参数。

stop_sequences
string[]

停止序列。

stream
boolean

是否流式返回(SSE)。

tools
object[]

工具定义(如需)。

Response

Claude 消息响应。stream=true 时返回 SSE。

id
string
Example:

"msg_xxx"

type
string
Example:

"message"

role
string
Example:

"assistant"

model
string
Example:

"claude-3-5-sonnet-20240620"

content
object[]
stop_reason
string | null
Example:

"end_turn"

usage
object

Claude 消息响应的 token 用量。