Docs

Message Token 计数

POST/v1/messages/count_tokens

对 Anthropic Messages 兼容请求体计算 token。

本页目录
  1. 认证
  2. 请求体
  3. 响应
  4. 请求示例

当客户端需要在发起生成请求前按 Anthropic Messages 请求形态计算 token 时,使用这个端点。请求体语义与 /v1/messages 一致。

认证

使用以下任一请求头:

Authorization: Bearer sk-your-api-key
x-api-key: sk-your-api-key

如果使用 x-api-key,同时发送 Anthropic 兼容客户端期望的版本请求头:

anthropic-version: 2023-06-01

请求体

参数 model

类型:string

位置:body

必填:是

当前 API Key 可用的 Claude 模型 ID。

参数 messages

类型:array

位置:body

必填:是

使用 Anthropic Messages 格式的消息数组。

参数 system

类型:string

位置:body

System prompt。

参数 tools

类型:array

位置:body

纳入 token 计数的工具定义。

响应

响应使用实际承接路由的供应商返回的 Anthropic 兼容 token 计数形态。

响应字段 input_tokens

类型:integer

输入 token 数。

请求示例

curl -X POST "https://api.anypath.dev/v1/messages/count_tokens" \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [
      {"role": "user", "content": "Summarize this support case."}
    ]
  }'