申请流程
要使用 Claude Messages Count Tokens API,首先到 Ace Data Cloud 控制台 获取您的 API Token,留作备用。
如果你尚未登录或注册,会自动跳转到登录页面邀请你注册和登录,完成后会自动返回当前页面。
一个 API Token 即可调用平台所有服务,无需为每个服务单独申请。 首次申请会赠送免费额度,可免费体验;额度不足时可在 控制台 充值通用余额。
📘 完整文档:Claude Messages Count Tokens API →
基本使用
Claude Messages Count Tokens API 的请求路径为/v1/messages/count_tokens,与 Anthropic 官方 API 保持一致。我们至少需要提供两个必填参数:
model:选择使用的 Claude 模型,如最新旗舰claude-fable-5-1;原claude-fable-5仍兼容保留。messages:输入的消息数组,每条消息包含role(角色)和content(内容)。
system:系统提示词,会计入 Token 数量。tools:工具定义,会计入 Token 数量。thinking:扩展思考配置。tool_choice:工具选择配置。cache_control:顶层或内容块级缓存控制配置。
messages、system、工具调用回放、URL 图片和 document/PDF 内容块使用与 Messages API 相同的稳定请求结构。
cURL 示例
Python 示例
使用 Anthropic SDK
Claude Messages Count Tokens API 接受 Anthropic SDK 的稳定请求结构,可以通过anthropic 库调用。接口使用所选模型对应的原生 Count Tokens 能力统计输入,可用于在发送 Messages 请求前检查输入规模。
包含工具的 Token 计数
如果你的请求中包含工具定义,这些工具也会计入 Token 数量:包含系统提示词的 Token 计数
系统提示词也会计入 Token 数量:注意事项
- 该 API 仅计算输入 Token 数量,不会产生任何模型输出。
- Token 计数结果可用于预估输入规模和检查上下文窗口;最终计费以实际 Messages 响应中的
usage为准。 - 图片、PDF、工具定义、系统提示词和 thinking 配置会按照所选模型的输入规则计入结果。
- 该 API 完全免费,不消耗任何额度。

