文字
計算訊息 Token
計算 Messages 請求的輸入 token 數量,而不產生回應。
概覽
發送與 建立訊息 相同的 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 -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!"}
]
}'回應
{
"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