建立訊息請求 (Claude 原生)

Anthropic Claude 原生訊息格式, 相容官方 SDK 與工具鏈

POST /v1/messages

鉴权: {'type': 'bearer', 'prefix': 'sk-', 'description': 'API Key, 使用 `Authorization: Bearer sk-xxx` 鉴权'}

原生 Claude Messages API。如果你的程式碼已經在用 Anthropic 官方 SDK, 只需把 `base_url` 指向本平臺, 其餘程式碼不改即可執行。 - 支援 `stream: true` SSE 流式 - 支援工具呼叫 / 圖片輸入 - 與 OpenAI 端點的區別: `system` 是頂層欄位而非 messages 元素

请求体

`model`	string	required	要呼叫的模型名, 填模型廣場裡的名稱。
`messages`	array	required	對話訊息陣列, 每項含 role 與 content。role 只能是 user / assistant, 系統提示詞走獨立的 system 欄位而不是放進這裡。
`role`	string	required
`content`	string	required	字串, 或多模態陣列
`max_tokens`	integer	required	本次回覆最多生成多少 token。這個協議下是必填項。
`system`	string		系統提示詞。可傳字串, 也可傳陣列以便對不同片段單獨設定。
`stream`	boolean		是否流式返回。true 時以 SSE 逐塊推送。
`temperature`	number		取樣溫度, 越大輸出越發散、越小越穩定。
`tools`	array		可供模型呼叫的工具列表。模型需要時會返回 tool_use 內容塊, 由你執行後以 tool_result 回填。
`tool_choice`	object		控制是否/如何選用工具: 由模型決定、強制使用、或指定某個具體工具。需與 tools 一起使用。
`stop_sequences`	array		遇到其中任一字串就停止生成。
`top_p`	number		核取樣, 只在累計機率前 top_p 的候選裡挑。與 temperature 選一個調即可。
`top_k`	integer		只在機率最高的 k 個候選裡挑。
`thinking`	object		擴充套件思考設定, 讓模型在回答前先推理。開啟後思考過程會作為獨立內容塊返回, 並計入輸出用量。僅支援該能力的模型有效。
`metadata`	object		自定義元資訊, 便於你自己歸類檢索。

响应

200 — 返回 Claude Messages 原生結構

调用示例

curl https://api.router.ai/v1/messages \
  -H "Authorization: Bearer sk-xxx" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 512,
    "system": "用简洁中文回答",
    "messages": [{"role": "user", "content": "你好"}]
  }'

## 其他欄位本端點採用 Anthropic 原生請求格式。上表之外的欄位按 Anthropic 官方規範原樣傳入即可, 不需要額外適配。

API 文件