跳轉到主要內容
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
  }
}