Claude Messages Count Tokens API の申請および使用

Claude AI API guide - Ace Data Cloud

Claude Messages Count Tokens API は、実際にメッセージを作成することなく、ツール、画像、ドキュメントなどのコンテンツの Token カウントを含む、1 つの Message の入力 Token 数を計算できます。これは、コストを見積もる必要がある場合や、入力がモデルのコンテキスト制限を超えていないか確認する場合に非常に役立ちます。

本ドキュメントでは主に Claude Messages Count Tokens API の使用フローを紹介します。

​

申請フロー

Claude Messages Count Tokens API を使用するには、まず Ace Data Cloud コンソール で API Token を取得し、予備として保管してください。

まだログインまたは登録していない場合は、自動的にログインページへ移動し、登録とログインを促されます。完了後は自動的に現在のページへ戻ります。

1 つの API Token でプラットフォームのすべてのサービスを呼び出すことができ、サービスごとに個別に申請する必要はありません。 初回申請時には無料クレジットが付与され、無料で試すことができます。クレジットが不足した場合は、コンソール で共通残高をチャージできます。

📘 完全なドキュメント：Claude Messages Count Tokens API →

​

基本的な使用方法

Claude Messages Count Tokens API のリクエストパスは /v1/messages/count_tokens であり、Anthropic 公式 API と一致しています。少なくとも 2 つの必須パラメータを指定する必要があります。

• model：使用する Claude モデルを選択します。claude-opus-5-5 は、最新フラッグシップの claude-fable-5-1 などの Messages Token Count に使用できます。旧 claude-fable-5 も引き続き互換性を維持しています。claude-sonnet-5-5 はネイティブ Messages シリーズインターフェースに追加されており、画像入力と適応型思考をサポートしています。その入力、出力、キャッシュ読み取りの公式参考価格は、それぞれ 100 万 Token あたり 2、10、0.20 米ドルです。
• messages：入力メッセージの配列で、各メッセージには role（ロール）と content（内容）が含まれます。

一般的なオプションパラメータ：

• system：システムプロンプト。Token 数に含まれます。
• tools：ツール定義。Token 数に含まれます。
• thinking：拡張思考の設定。
• tool_choice：ツール選択の設定。
• cache_control：トップレベルまたはコンテンツブロックレベルのキャッシュ制御設定。

messages、system、ツール呼び出しの再生、URL 画像、および document/PDF コンテンツブロックは、Messages API と同じ安定したリクエスト構造を使用します。

​

cURL の例

curl -X POST 'https://api.acedata.cloud/v1/messages/count_tokens' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "model": "claude-fable-5-1",
    "messages": [
      {
        "role": "user",
        "content": "Hello, Claude"
      }
    ]
  }'

​

Python の例

import httpx

url = "https://api.acedata.cloud/v1/messages/count_tokens"
headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json",
}
payload = {
    "model": "claude-fable-5-1",
    "messages": [
        {
            "role": "user",
            "content": "Hello, Claude"
        }
    ],
}
response = httpx.post(url, headers=headers, json=payload)
print(response.json())

返却結果の例：

{
  "input_tokens": 11
}

​

Anthropic SDK の使用

Claude Messages Count Tokens API は Anthropic SDK の安定したリクエスト構造を受け入れ、anthropic ライブラリを通じて呼び出すことができます。インターフェースは、選択したモデルに対応するネイティブ Count Tokens 機能を使用して入力を統計し、Messages リクエストを送信する前に入力規模を確認するために使用できます。

from anthropic import Anthropic

client = Anthropic(
    api_key="{token}",
    base_url="https://api.acedata.cloud",
)

result = client.messages.count_tokens(
    model="claude-opus-4-8",
    messages=[
        {
            "role": "user",
            "content": "Hello, Claude"
        }
    ],
)
print(result.input_tokens)

​

ツールを含む Token カウント

リクエストにツール定義が含まれている場合、これらのツールも Token 数に含まれます。

result = client.messages.count_tokens(
    model="claude-opus-4-8",
    messages=[
        {
            "role": "user",
            "content": "What is the weather in San Francisco?"
        }
    ],
    tools=[
        {
            "name": "get_weather",
            "description": "Get the current weather in a given location",
            "input_schema": {
                "type": "object",
                "properties": {
                    "location": {
                        "type": "string",
                        "description": "The city and state, e.g. San Francisco, CA"
                    }
                },
                "required": ["location"]
            }
        }
    ],
)
print(result.input_tokens)

​

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

システムプロンプトも Token 数に含まれます。

result = client.messages.count_tokens(
    model="claude-opus-4-8",
    system="You are a helpful assistant that speaks Chinese.",
    messages=[
        {
            "role": "user",
            "content": "Hello"
        }
    ],
)
print(result.input_tokens)

​

注意事項

• この API は入力 Token 数のみを計算し、モデル出力は一切生成しません。
• Token カウント結果は入力規模の見積もりとコンテキストウィンドウの確認に使用できます。最終的な課金は実際の Messages レスポンス内の usage に準拠します。
• 画像、PDF、ツール定義、システムプロンプト、および thinking 設定は、選択したモデルの入力ルールに従って結果に含まれます。
• この API は完全無料であり、クレジットを一切消費しません。