Skip to main content
更新日期:2026-06-06

Claude Token 计数

用于在真正调用 POST /v1/messages 之前,先预估输入部分会消耗多少 Token。适合 Claude CLI、Claude Code、预算控制或上下文裁剪逻辑。

认证

推荐使用 Anthropic 风格请求头:
也可以使用标准 Bearer 认证,但 Anthropic 生态客户端通常会携带上面的头。

请求体

请求体沿用 Claude Messages 风格。最小可用字段通常是:
  • model
  • messages
如果请求里包含 systemtools、工具结果或文本内容,也会一起参与估算。

请求示例

响应示例

返回字段

限制说明

当前实现主要估算:
  • system
  • messages 中的文本内容
  • 工具定义和工具结果中的文本/JSON
如果请求里包含图片或文件,这个接口不会把对应的图片/文件 Token 计入 input_tokens。此时响应里可能出现 warning,实际计费会高于这里的估算值。
这个接口返回的是预估值,不是最终结算值。真正的用量仍以实际模型调用结果为准。