Claude 消息 Token 计算

本接口用于在真实发起推理请求前，准确计算和预估发送给 Claude 模型的输入 Token 数量。这能帮助用户有效地进行成本控制、优化 Prompt，以及避免由于请求体过大超过模型窗口限制。

🌟 接口特性

100% 免费：调用此 Token 计算接口不消耗任何账户积分或订阅包额度，即使你的账户余额为 0 也可以正常调用。
全格式多模态支持：完美支持文本、系统提示词（System Prompts）、工具定义（Tools）、以及图片输入（URL 或 Base64 格式）的复杂混合请求。
极致的容错保障：后台自带智能容错映射。即使针对不直接支持 CountTokens 的跨区域推理 profile 或自定义 ARN 模型，也能自动降级并返回 100% 准确的分词计数。

接口定义

请求方法：POST
请求 URL：https://easyrouter.io/v1/messages/count_tokens
请求头：
- Authorization: Bearer sk-your-token (你的 EasyRouter API 令牌)
- Content-Type: application/json

请求参数

请求体参数与标准 Claude Messages 接口完全一致。

响应参数

返回一个标准 JSON 对象：

input_tokens (integer): 计算得出的总输入 Token 数量。

调用示例

示例 1：计算普通文本与 System 提示词

curl -X POST https://easyrouter.io/v1/messages/count_tokens \
  -H "Authorization: Bearer sk-your-token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "system": "You are a professional system architect.",
    "messages": [
        {
            "role": "user",
            "content": "How to design a high-availability cache layer?"
        }
    ]
  }'

响应示例：

{
  "input_tokens": 32
}

示例 2：计算包含多模态图片的请求

本接口完美支持图片转译。EasyRouter 会自动处理图片分词，并返回高精度的图片折算 Token 数量。

curl -X POST https://easyrouter.io/v1/messages/count_tokens \
  -H "Authorization: Bearer sk-your-token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "messages": [
        {
            "role": "user",
            "content": [
                {
                    "type": "text",
                    "text": "Identify the content of this image."
                },
                {
                    "type": "image",
                    "source": {
                        "type": "url",
                        "url": "https://easyrouter.io/logo.png"
                    }
                }
            ]
        }
    ]
  }'

响应示例：

{
  "input_tokens": 542
}