API 參考
Messages(Anthropic 格式)
這個端點可用的模型(5)
POST
/v1/messagesAnthropic 原生傳輸格式,用同一把 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 或錯誤訊息傳給我們,我們來查。