跳到正文

创建消息

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

相关页面