Skip to main content
Claude Messages Count Tokens API は、実際にメッセージを作成することなく、メッセージの入力トークン数を計算できます。これにはツール、画像、ドキュメントなどの内容のトークンカウントが含まれます。これは、コストを見積もったり、入力がモデルのコンテキスト制限を超えていないかを確認したりする際に非常に便利です。 この文書では、Claude Messages Count Tokens API の使用プロセスについて説明します。

申請プロセス

Claude Messages Count Tokens API を使用するには、まず Ace Data Cloud コンソール にアクセスして、API トークンを取得し、保管してください。 まだログインまたは登録していない場合は、自動的にログインページにリダイレクトされ、登録とログインを促されます。完了後、現在のページに自動的に戻ります。 1つの API トークンでプラットフォームのすべてのサービスを呼び出すことができ、各サービスごとに個別に申請する必要はありません。 初回申請時には無料のクレジットが付与され、無料で体験できます。クレジットが不足した場合は、コンソール で一般的な残高をチャージできます。
📘 完全な文書:Claude Messages Count Tokens API →

基本使用

Claude Messages Count Tokens API のリクエストパスは /v1/messages/count_tokens で、Anthropic の公式 API と一致しています。少なくとも2つの必須パラメータを提供する必要があります:
  • model:使用する Claude モデルを選択します。最新のフラッグシップ claude-fable-5-1 を選択できます。元の claude-fable-5 も互換性を保っています。
  • messages:入力メッセージの配列で、各メッセージには role(役割)と content(内容)が含まれます。
一般的なオプションパラメータ:
  • system:システムプロンプトで、トークン数にカウントされます。
  • tools:ツール定義で、トークン数にカウントされます。
  • thinking:思考拡張設定。
  • tool_choice:ツール選択設定。
  • cache_control:トップレベルまたはコンテンツブロックレベルのキャッシュ制御設定。
messagessystem、ツール呼び出しの再生、URL 画像および document/PDF コンテンツブロックは、Messages API と同じ安定したリクエスト構造を使用します。

cURL の例

Python の例

返される結果の例:

Anthropic SDK の使用

Claude Messages Count Tokens API は、Anthropic SDK の安定したリクエスト構造を受け入れ、anthropic ライブラリを通じて呼び出すことができます。現在の返り値は Ace Data Cloud のローカル推定器によって計算されており、Anthropic の公式トークナイザーの正確な結果ではありません。マルチモーダル、ツール、および異なる Claude モデルの実際のトークン数には偏差がある可能性があります。

ツールを含むトークンカウント

リクエストにツール定義が含まれている場合、これらのツールもトークン数にカウントされます:

システムプロンプトを含むトークンカウント

システムプロンプトもトークン数にカウントされます:

注意事項

  • この API は入力トークン数のみを計算し、モデル出力は生成しません。
  • トークンカウント結果は入力規模の粗い見積もりに使用でき、正確な請求、コンテキストウィンドウの制限、またはモデルトークナイザーの比較の基準として使用すべきではありません。
  • 現在の推定器は、画像や PDF の視覚/文書トークンを正確に計算せず、異なる Claude モデルの公式トークナイザーの違いを反映することはできません。
  • この API は完全に無料で、いかなるクレジットも消費しません。