Claude Messages

對於傳送 Anthropic 風格訊息酬載的用戶端，請使用 Claude 相容的 Messages 端點。

POST https://getrouter.ai/v1/messages

基本請求

curl https://getrouter.ai/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "max_tokens": 512,
    "system": "請清楚且簡潔地回答。",
    "messages": [
      {"role": "user", "content": "說明 Base URL 的用途。"}
    ]
  }'

回應採用 Claude 相容的訊息結構，包含內容區塊，並在可用時提供用量資訊。

必填欄位

欄位	說明
`model`	Claude 相容的模型 ID
`messages`	對話訊息
`max_tokens`	輸出 token 數量上限

選填欄位

API 結構描述包含以下欄位：

system
temperature、top_p 與 top_k
stream
stop_sequences
tools 與 tool_choice
thinking
context_management
output_config 與 output_format
metadata
speed 與 service_tier

支援情況取決於模型。請勿僅因為某個選項出現在結構描述中就傳送它；請先確認所選模型支援該選項。

串流

若模型支援 Claude 相容串流，請將 stream 設為 true：

{
  "model": "MODEL_ID",
  "max_tokens": 512,
  "stream": true,
  "messages": [
    {"role": "user", "content": "撰寫一則簡短的版本說明。"}
  ]
}

請使用 Claude 事件剖析器，而非 Chat Completions 或 Responses 剖析器。

工具與思考支援

Claude 相容的工具定義、工具結果區塊及思考設定，需要具備相應功能的模型。為無人看管的代理程式啟用前，請先測試完整工作流程。

Warning

同一個 Claude 模型 ID 透過 OpenAI 相容端點使用，以及透過 /v1/messages 使用時，可能需要不同的請求與回應處理方式。請設定用戶端預期的協定。

工具整合

Claude 相容的程式設計用戶端等工具，可能需要額外的環境變數或供應商設定。請依照整合中的專用指南操作，而非只替換主機名稱。

#Claude Messages

#基本請求

#必填欄位

#選填欄位

#串流

#工具與思考支援

#工具整合

#後續步驟