创建消息
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