开发文档
Messages API
直接接收 Anthropic 原生格式。基于 Claude SDK 编写的代码只需更改 base_url。
请求格式
system 为顶层字段,且 max_tokens 为必填。这两点与 Chat Completions 不同。
| Field | Type | Required | Note |
|---|---|---|---|
| model | string | Yes | Model ID or route path |
| messages | array | Yes | user, assistant |
| system | string | No | Top-level field |
| max_tokens | integer | Yes | Required 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 分钟缓存写入按不同单价计费。
取消流式传输与计费
在流式传输途中断开连接,上游的生成不一定随之停止。网关会在既定的时间与输出上限内将响应读取到结束,并按上游报告的最终用量计费。若先达到上限,则按截至当时已生成的内容估算计费。