テキスト
メッセージトークンをカウントする
レスポンスを作成せずに、Messagesリクエストの入力トークンをカウントします。
概要
メッセージを作成 と同じ model、messages、system、tools、および thinking フィールドを送信します(max_tokens は含めません)。これにより、リクエストを送信する前に入力トークンをカウントできます。モデルの accepted_request_formats に anthropic_messages が含まれている必要があります。
注意事項
- トークンカウントにはAPIキーが必要ですが、課金は発生しません。
- このカウントは計画用です。実際のリクエストに対する課金は、そのレスポンス内の
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
リクエスト内の推定入力トークン数。
認証
BearerAuth AuthorizationBearer <token>
APIキー認証。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