TokenLab

文字

計算訊息 Token

計算 Messages 請求的輸入 token 數量,而不產生回應。

POST
/v1/messages/count_tokens

概覽

發送與 建立訊息 相同的 model、messages、system、tools 和 thinking 欄位(不包含 max_tokens),以便在發送請求前計算輸入 token 數量。該模型必須在 accepted_request_formats 中列出 anthropic_messages。

注意事項

  • Token 計算需要 API key,且不計費。
  • 此計數僅供規劃使用。實際請求的費用將根據其回應中的 usage 計算。
  • TokenLab 優先使用模型自身的計數器。當該計數器不可用時,TokenLab 會返回本地估算值,並設定回應標頭 X-TokenLab-Count-Tokens-Source: local_estimate。
  • 身份驗證、權限和輸入錯誤仍會導致失敗。引用 file_id 的請求需要模型自身的計數器,若無法使用則會返回 503。發送此類請求時,請同時發送 anthropic-beta: files-api-2025-04-14。

範例

請求

cURL
curl -X POST "https://api.tokenlab.sh/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-5",
    "messages": [
      {"role": "user", "content": "Hello, Claude!"}
    ]
  }'

回應範例

回應

200 OK
{
  "input_tokens": 12
}

重要欄位

input_tokensinteger
請求中輸入 token 的估算數量。

授權

BearerAuth
AuthorizationBearer <token>

API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。

位置: header

請求主體

application/json

回應

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json