Claude Sonnet 5.5 · Messages

POST/v1/messages

請求參數

Authorization

在 Header 加入參數 Authorization，其值為 Bearer 之後拼接你的 API Key。

Authorization: Bearer ****************

anthropic-version: 2023-06-01

Header 參數

Content-Typestring可選

application/json

Acceptstring可選

application/json

Body 參數application/json必填

modelstring必需

模型 ID，固定為 `claude-sonnet-5-5`

messagesarray[object]必需

對話訊息清單；每則含 `role`（user / assistant）與 `content`（文字或內容區塊）

max_tokensinteger必需

最大生成 token 數；Anthropic API 必填

systemstring | array[object]可選

系統提示詞，作為頂層欄位傳入（不放進 messages）

streamboolean可選

是否串流回傳（SSE），預設 `false`

stop_sequencesarray[string]可選

自訂停止序列，命中即停止生成

toolsarray[object]可選

工具定義，用於工具呼叫

tool_choiceobject可選

控制是否及使用哪個工具

metadataobject可選

請求中繼資料，例如 `user_id`

thinkingobject可選

省略此欄位時預設啟用自適應思考；可用 `disabled` 關閉

output_configobject可選

輸出設定；可用子欄位取決於模型

範例

{
  "model": "claude-sonnet-5-5",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "你好，介紹一下你自己"
    }
  ]
}

{  "model": "claude-sonnet-5-5",  "max_tokens": 1024,  "messages": [    {      "role": "user",      "content": "你好，介紹一下你自己"    }  ]}

請求範例程式碼

curl https://api.hotrouter.ai/v1/messages \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [
      {
        "role": "user",
        "content": "你好，介紹一下你自己"
      }
    ]
  }'

curl https://api.hotrouter.ai/v1/messages \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -H "anthropic-version: 2023-06-01" \  -d '{    "model": "claude-sonnet-5-5",    "max_tokens": 1024,    "messages": [      {        "role": "user",        "content": "你好，介紹一下你自己"      }    ]  }'

回應

200 · 成功

idstring必需

本次回應的唯一 id

typestring必需

物件類型（message）

rolestring必需

訊息角色

contentarray[object]必需

內容區塊陣列

stop_reasonstring可選

結束原因（end_turn / max_tokens 等）

usageobject必需

本次呼叫的 token 用量

範例

{
  "id": "msg_xxx",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "你好！很高興見到你……"
    }
  ],
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 12,
    "output_tokens": 24
  }
}

{  "id": "msg_xxx",  "type": "message",  "role": "assistant",  "content": [    {      "type": "text",      "text": "你好！很高興見到你……"    }  ],  "stop_reason": "end_turn",  "usage": {    "input_tokens": 12,    "output_tokens": 24  }}

Claude Sonnet 5.5 · Messages

請求參數

請求範例程式碼

回應

On this page