建立訊息
Anthropic Messages API:Claude 模型的原生協定,DeepSeek、通義千問與美國區模型同樣可用;Base URL 不帶 /v1,Anthropic SDK 與 Claude Code 直接可用。
/v1/messagesClaude 模型走 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 · 扣費。
請求標頭
Bearer sk-…;也可改用 x-api-key: sk-…,二者擇一
SDK 會自動帶上,原樣轉發,例如 2023-06-01
Beta 功能開關,原樣轉發
請求主體參數JSON
目前密鑰分組內的模型 ID(Claude,或 DeepSeek、通義千問等支援本協定的模型);分組不包含該模型時回傳 404 model_not_found
網關不設上限,最大值按模型官方規格。官方 API 要求必填,HopBase 在未傳時補為 4096:長輸出會在 4096 處截斷(stop_reason: "max_tokens"),請明確設定
預設4096
按 Anthropic 官方格式,原樣轉發
數量≥ 1 項
user 或 assistant
字串,或內容塊陣列(text、image、tool_use、tool_result 等)
系統提示詞,原樣轉發
true 回傳 Anthropic SSE 事件流
預設false
Anthropic 工具定義(name、description、input_schema),原樣轉發
延伸思考配置,原樣轉發,取值按 Anthropic 官方規格
原樣轉發,範圍按 Anthropic 官方規格
回傳
200成功。非串流為 message JSON;stream: true 時為 Anthropic SSE
回應標頭
本次請求扣費的人民幣金額(與 X-HopBase-Cost-USD 為同一筆扣費),最多 6 位小數,如 0.0816。只在本次產生扣費時回傳;串流(SSE)不回傳;生圖耗時約 40 秒以上時回應標頭已提前送出,以回應主體 usage.cost 為準
本次請求實際從餘額扣除的美元金額,與使用記錄裡這一筆相同,最多 8 位小數,如 0.012;只隨 X-HopBase-Cost 一起回傳
X-HopBase-Cost 的幣種,恆為 CNY
訊息 ID
模型 ID
內容塊
text / thinking / tool_use
text 塊的文字
tool_use:工具名
tool_use:工具參數
end_turn / max_tokens / tool_use / stop_sequence
Token 用量
輸入 Token
輸出 Token
寫入快取的輸入 Token
命中快取的輸入 Token
閘道附加:本次扣費的人民幣金額(與 cost_usd 為同一筆扣費),與回應標頭 X-HopBase-Cost 相同;串流不回傳
閘道附加:本次實際從餘額扣除的美元金額,與回應標頭 X-HopBase-Cost-USD 及使用記錄相同;串流不回傳
閘道附加:cost 的幣種,恆為 CNY
錯誤
{"type":"error","error":{"type":"invalid_request_error","message":"…"}},沒有 code。密鑰校驗階段的錯誤(401、402、403)仍為 OpenAI 結構missing_api_key / invalid_api_key / api_key_expired)insufficient_quota)model_not_found),或路徑不屬於該分組(route_not_found)request_too_large)user_concurrency_limit / apikey_concurrency_limit),帶 Retry-After