跳到正文
alpharouter

开发文档

Messages API

直接接收 Anthropic 原生格式。基于 Claude SDK 编写的代码只需更改 base_url。

请求格式

system 为顶层字段,且 max_tokens 为必填。这两点与 Chat Completions 不同。

FieldTypeRequiredNote
modelstringYesModel ID or route path
messagesarrayYesuser, assistant
systemstringNoTop-level field
max_tokensintegerYesRequired on this path

路由行为

此路径同样可使用路由路径,但候选仅限支持 Messages 格式的模型。

内容块

响应的 content 是块数组,按顺序包含 text 与 tool_use 块。

usage 与缓存写入

通过 cache_control 写入缓存的请求,会在 usage.cache_creation 中一并返回各 TTL 的令牌数(ephemeral_5m_input_tokens、ephemeral_1h_input_tokens)。cache_creation_input_tokens 为两者之和,1 小时缓存写入与 5 分钟缓存写入按不同单价计费。

取消流式传输与计费

在流式传输途中断开连接,上游的生成不一定随之停止。网关会在既定的时间与输出上限内将响应读取到结束,并按上游报告的最终用量计费。若先达到上限,则按截至当时已生成的内容估算计费。