第 12 章 / 共 21 章約 1 分鐘

12. Anthropic Messages 相容端點#

POST /v1/messages — 在 OpenAI 相容管線之上額外提供 Anthropic Messages API 協定相容,可被 官方 Anthropic 用戶端 / SDK 驅動,無論底層通道實際是 OpenAI 還是 Anthropic。支援非串流與串流(串流為伺服器端合成的 Anthropic SSE 事件序列)。

驗證注意事項#

該端點與其他端點一致,使用 Authorization: Bearer sk-... 驗證,不接受 Anthropic 預設的 x-api-key 標頭。使用 Anthropic 官方 SDK 時,需將金鑰以 Bearer 標頭方式傳入(例如透過 SDK 的 auth_token 參數或自訂請求標頭),而非預設的 api_key(後者傳送 x-api-key)。

能力範圍#

  • 支援:純文字 messages、system 提示、max_tokens、stream 等基礎欄位。
  • 不支援:tools / tool_choice(函式呼叫)、非文字內容區塊(圖片等多模態)。遇到這些欄位會直接回傳 400,錯誤主體為 Anthropic 格式,而非靜默丟棄。
  • 所有錯誤(含驗證、權限、參數)統一以 Anthropic error 格式回傳。
cURL
curl http://183.240.79.21:52099/v1/messages \
  -H "Authorization: Bearer sk-你的YiTuoToken-Key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3-5-sonnet-20241022",
    "max_tokens": 256,
    "system": "你是一个简洁的助手。",
    "messages": [
      { "role": "user", "content": "用一句话介绍你自己" }
    ]
  }'

如需函式呼叫 / 多模態等進階功能,請改用 /v1/chat/completions(OpenAI 格式)。