テキスト

メッセージトークンをカウントする

レスポンスを作成せずに、Messagesリクエストの入力トークンをカウントします。

POST
/v1/messages/count_tokens

概要

メッセージを作成 と同じ 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
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
リクエスト内の推定入力トークン数。

認証

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