跳到正文

建立訊息

Anthropic Messages API:Claude 模型的原生協定,DeepSeek、通義千問與美國區模型同樣可用;Base URL 不帶 /v1,Anthropic SDK 與 Claude Code 直接可用。

POST/v1/messages

Claude 模型走 Anthropic 協定;DeepSeek、通義千問與美國區(-us)模型同樣支援,其他模型以各模型頁為準。SDK 的 Base URL 填 https://api.hop-base.com(不帶 /v1),請求路徑仍是 /v1/messages;另支援 POST /v1/messages/count_tokens。

下表只列網關會補值或特別處理的部分;其餘 Messages API 欄位原樣轉發,取值範圍按 Anthropic 官方規格。Claude 模型也可以用 OpenAI 相容的 /v1/chat/completions 調用,但本端點功能最全:工具調用之間保留思考內容,並支援提示快取控制與 Anthropic 原生參數。/v1/responses 不支援 Claude 模型,回傳 404「目前平台不支援此 API 路徑」。

產生扣費的非串流回應會回傳本次實際扣費:回應標頭 X-HopBase-Cost / X-HopBase-Cost-USD / X-HopBase-Currency,以及回應主體根物件 usage 裡的 cost / cost_usd / currency(usage 原有欄位保留)。cost_usd 為本次從餘額實際扣除的美元金額,cost 為同一筆扣費的人民幣金額,currency 恆為 CNY。串流(SSE)不回傳,請到控制台「使用記錄」查看;未扣費的回應(如錯誤)不帶。詳見帳戶 API · 扣費。

請求標頭

Authorization:選填string

Bearer sk-…;也可改用 x-api-key: sk-…,二者擇一

anthropic-version:選填string

SDK 會自動帶上,原樣轉發,例如 2023-06-01

anthropic-beta:選填string

Beta 功能開關,原樣轉發

請求主體參數JSON

model:必填string

目前密鑰分組內的模型 ID(Claude,或 DeepSeek、通義千問等支援本協定的模型);分組不包含該模型時回傳 404 model_not_found

max_tokens:選填integer

網關不設上限,最大值按模型官方規格。官方 API 要求必填,HopBase 在未傳時補為 4096:長輸出會在 4096 處截斷(stop_reason: "max_tokens"),請明確設定

預設4096

messages:必填array of object

按 Anthropic 官方格式,原樣轉發

數量≥ 1 項

system:選填string 或 array

系統提示詞,原樣轉發

stream:選填boolean

true 回傳 Anthropic SSE 事件流

預設false

tools:選填array of object

Anthropic 工具定義(name、description、input_schema),原樣轉發

thinking:選填object

延伸思考配置,原樣轉發,取值按 Anthropic 官方規格

temperature:選填number

原樣轉發,範圍按 Anthropic 官方規格

回傳

200成功。非串流為 message JSON;stream: true 時為 Anthropic SSE

回應標頭

X-HopBase-Cost:選填string

本次請求扣費的人民幣金額(與 X-HopBase-Cost-USD 為同一筆扣費),最多 6 位小數,如 0.0816。只在本次產生扣費時回傳;串流(SSE)不回傳;生圖耗時約 40 秒以上時回應標頭已提前送出,以回應主體 usage.cost 為準

X-HopBase-Cost-USD:選填string

本次請求實際從餘額扣除的美元金額,與使用記錄裡這一筆相同,最多 8 位小數,如 0.012;只隨 X-HopBase-Cost 一起回傳

X-HopBase-Currency:選填string

X-HopBase-Cost 的幣種,恆為 CNY

id:選填string

訊息 ID

type:選填"message"
role:選填"assistant"
model:選填string

模型 ID

content:選填array of object

內容塊

stop_reason:選填string

end_turn / max_tokens / tool_use / stop_sequence

usage:選填object

Token 用量

錯誤

400Anthropic 結構:{"type":"error","error":{"type":"invalid_request_error","message":"…"}},沒有 code。密鑰校驗階段的錯誤(401、402、403)仍為 OpenAI 結構
401沒帶密鑰、密鑰無效或已過期(missing_api_key / invalid_api_key / api_key_expired)
402餘額或密鑰 / 成員 / 部門額度用完(insufficient_quota)
404模型不在這把密鑰的分組裡(model_not_found),或路徑不屬於該分組(route_not_found)
413請求體超過 60 MB(request_too_large)
429帳戶或密鑰並行已達上限(user_concurrency_limit / apikey_concurrency_limit),帶 Retry-After

相關頁面