KToken Docs

Appearance

POST /v1/messages/count_tokens ​

接口用途 ​

Anthropic Count Tokens 兼容接口，用于预估消息请求的 token 用量。

请求路径 ​

text
POST /v1/messages/count_tokens

认证方式 ​

  • Authorization: Bearer <API_KEY>
  • x-api-key: <API_KEY>

路由别名 ​

无。

适用平台 ​

  • Anthropic / Claude 分组：支持
  • OpenAI 分组：明确不支持
  • Antigravity：在 /antigravity/v1/messages/count_tokens 下有专用入口

上游官方规范 ​

本项目支持说明 ​

请求体解析逻辑与 /v1/messages 接近，也要求：

  • 请求体非空
  • JSON 合法
  • model 必填

参数说明 ​

常用字段与 /v1/messages 基本一致，重点仍是：

| 参数 | 类型 | 必填 | 说明 | | ---------- | -------- | ------ | -------- | -------- | | model | string | 是 | 目标模型 | | messages | array | 是 | 消息数组 | | system | string | array | 否 | 系统提示 |

完整字段请参考 Anthropic 官方规范。

响应说明 ​

成功时返回标准 token 统计结果。

错误响应 ​

OpenAI 分组调用 ​

如果当前 API Key 所属分组平台是 OpenAI，这个接口会直接返回：

json
{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "Token counting is not supported for this platform"
  }
}

常规参数错误 ​

json
{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "Request body is empty"
  }
}

示例请求 ​

bash
curl https://example.com/v1/messages/count_tokens \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "messages": [
      { "role": "user", "content": "帮我估算 token" }
    ]
  }'

注意事项 ​

  • 这不是跨平台统一能力
  • 如果你希望兼容 OpenAI 分组，请不要依赖此接口