API 參考

Messages(Anthropic 格式)

POST/v1/messages

Anthropic 原生傳輸格式,用同一把 Bearer 金鑰。Claude Code 和官方 anthropic SDK 只改 base URL 就能用——沒有轉接層,不做格式轉換。

#請求參數

  • modelstring必填

    Claude 模型 ID,見模型頁,例如 claude-opus-5-5。

  • max_tokensinteger必填

    Anthropic 格式要求必填——輸出硬上限。

  • messagesarray必填

    Anthropic 風格輪次:{role: user|assistant, content}。

  • systemstring選填

    系統提示詞——這裡是頂層欄位,不是 message 角色。

  • streamboolean選填

    以串流回傳 Anthropic 原生 SSE 事件(message_start、content_block_delta……)。

  • temperaturenumber選填

    依 Anthropic 的範圍為 0 到 1。

  • toolsarray選填

    Anthropic 工具定義;tool_use 區塊隨 content 回傳。

anthropic-version 標頭

按官方 API 要求帶上 anthropic-version: 2023-06-01。Authorization: Bearer 可用;原版 Anthropic SDK 發的 x-api-key 也接受。

#相關錯誤碼

  • 400 invalid_request_error請求主體格式錯誤,或該模型不支援某個參數。
  • 401Bearer 權杖無效或缺失。這條路徑不帶 error.code,請依狀態碼判斷。
  • 402 insufficient_user_quota錢包餘額不足以覆蓋預扣估算。
  • 429金鑰級限流。回應主體為空,按 Retry-After 等待。若 429 帶有 insufficient_user_quota,那是每日消費上限,不是限流。
  • 503 model_not_found模型名稱不存在,或目前沒有健康的通道可以提供服務。

完整錯誤碼表 →

#請求範例

curl https://www.aisplice.store/v1/messages \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 512,
    "messages": [{"role": "user", "content": "Say hello."}]
  }'

#回應

response.json
{
  "id": "msg_…",
  "type": "message",
  "role": "assistant",
  "model": "claude-opus-5-5",
  "content": [{"type": "text", "text": "Hello!"}],
  "stop_reason": "end_turn",
  "usage": {"input_tokens": 10, "output_tokens": 5}
}

還是沒解決?

把請求 ID 或錯誤訊息傳給我們,我們來查。