跳转到主要内容
POST
/
v1
/
messages
curl --request POST \
  --url https://toapis.com/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "你好，请介绍一下你自己"
      }
    ]
  }'

{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "你好！我是 Claude，由 Anthropic 开发的 AI 助手。我可以帮助你回答问题、分析信息、编写代码、创作内容等。有什么我可以帮你的吗？"
    }
  ],
  "model": "claude-sonnet-4-6",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 38
  }
}
  • 兼容 Anthropic Messages API 原生格式
  • 支持 Anthropic 官方 SDK（Python / JavaScript）直接对接，仅需修改 base_url
  • 支持流式输出（SSE）
  • 支持多轮对话、系统提示词、视觉输入、工具调用
如果你已经在使用 OpenAI SDK，建议使用 OpenAI 格式接口。 如果你在使用 Anthropic SDK 或 Claude Code，推荐使用本接口。

​
Authorizations

​
Authorization
string
Bearer Token 认证，适用于直接 HTTP 调用
Authorization: Bearer YOUR_API_KEY
​
x-api-key
string
API Key 认证，与 Anthropic SDK 兼容
x-api-key: YOUR_API_KEY
​
anthropic-version
string
默认值:"2023-06-01"
Anthropic API 版本号，使用 Anthropic SDK 时自动传入推荐值：2023-06-01

​
Body

​
model
string
必填
模型名称支持所有 Claude 系列模型，例如：
  • claude-opus-4-6
  • claude-sonnet-4-6
  • claude-haiku-4-5
​
messages
object[]
必填
对话消息列表，按时间顺序排列。只支持 user 和 assistant 角色，系统提示词请使用顶层 system 字段
​
max_tokens
integer
必填
生成内容的最大 token 数量
  • Claude Sonnet 4-6 最大支持 64000
  • Claude Opus 4-6 最大支持 32000
​
system
string | object[]
系统提示词，在顶层设置（不放在 messages 中）支持字符串或内容块数组格式
​
stream
boolean
默认值:false
是否启用流式输出（Server-Sent Events）
  • true：逐 token 流式返回，事件格式遵循 Anthropic SSE 规范
  • false：等待完整响应后一次性返回
​
temperature
number
默认值:1
采样温度，控制输出随机性范围：0 ~ 1
​
top_p
number
核采样概率阈值范围：0 ~ 1，建议不要同时设置 temperature 和 top_p
​
stop_sequences
string[]
停止序列，遇到指定字符串时停止生成

​
Response

​
id
string
本次请求的唯一标识符，格式为 msg_*
​
type
string
对象类型，固定为 message
​
role
string
响应角色，固定为 assistant
​
content
object[]
生成的内容块列表
  • content[].type：内容类型，通常为 text
  • content[].text：生成的文本内容
​
model
string
实际使用的模型名称
​
stop_reason
string
停止原因
  • end_turn：模型正常结束
  • max_tokens：达到 max_tokens 限制
  • stop_sequence：触发了停止序列
​
usage
object
本次请求的 token 消耗统计
  • usage.input_tokens：输入 token 数
  • usage.output_tokens：输出 token 数
curl --request POST \
  --url https://toapis.com/v1/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "你好，请介绍一下你自己"
      }
    ]
  }'

{
  "id": "msg_01XFDUDYJgAACzvnptvVoYEL",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "你好！我是 Claude，由 Anthropic 开发的 AI 助手。我可以帮助你回答问题、分析信息、编写代码、创作内容等。有什么我可以帮你的吗？"
    }
  ],
  "model": "claude-sonnet-4-6",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 38
  }
}