Kontextverwaltung

Token-Zählung

Token-Zählung ermöglicht es Ihnen, die Anzahl der Token in einer Nachricht zu bestimmen, bevor Sie sie an Claude senden.

Token-Zählung ermöglicht es Ihnen, die Anzahl der Token in einer Nachricht zu bestimmen, bevor Sie sie an Claude senden, und hilft Ihnen, fundierte Entscheidungen über Ihre Prompts und Nutzung zu treffen. Mit Token-Zählung können Sie

Proaktiv Rate Limits und Kosten verwalten
Intelligente Modell-Routing-Entscheidungen treffen
Prompts auf eine bestimmte Länge optimieren

This feature is Zero Data Retention (ZDR) eligible. When your organization has a ZDR arrangement, data sent through this feature is not stored after the API response is returned.

So zählen Sie Message-Token

Der Token-Zählungs-Endpunkt akzeptiert die gleiche strukturierte Liste von Eingaben zum Erstellen einer Nachricht, einschließlich Unterstützung für System-Prompts, Tools, Bilder und PDFs. Die Antwort enthält die Gesamtzahl der Input-Token.

Die Token-Anzahl sollte als Schätzung betrachtet werden. In einigen Fällen kann die tatsächliche Anzahl der Input-Token, die beim Erstellen einer Nachricht verwendet werden, um einen kleinen Betrag abweichen.

Token-Zählungen können Token enthalten, die automatisch von Anthropic für Systemoptimierungen hinzugefügt werden. Sie werden nicht für von Systemen hinzugefügte Token abgerechnet. Die Abrechnung spiegelt nur Ihren Inhalt wider.

Unterstützte Modelle

Alle aktiven Modelle unterstützen Token-Zählung.

Token in grundlegenden Nachrichten zählen

import anthropic

client = anthropic.Anthropic()

response = client.messages.count_tokens(
    model="claude-opus-4-6",
    system="You are a scientist",
    messages=[{"role": "user", "content": "Hello, Claude"}],
)

print(response.json())

JSON

{ "input_tokens": 14 }

Token in Nachrichten mit Tools zählen

Server Tool Token-Zählungen gelten nur für den ersten Sampling-Aufruf.

import anthropic

client = anthropic.Anthropic()

response = client.messages.count_tokens(
    model="claude-opus-4-6",
    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"],
            },
        }
    ],
    messages=[{"role": "user", "content": "What's the weather like in San Francisco?"}],
)

print(response.json())

JSON

{ "input_tokens": 403 }

Token in Nachrichten mit Bildern zählen

#!/bin/sh

IMAGE_URL="https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg"
IMAGE_MEDIA_TYPE="image/jpeg"
IMAGE_BASE64=$(curl "$IMAGE_URL" | base64)

curl https://api.anthropic.com/v1/messages/count_tokens \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-opus-4-6",
    "messages": [
        {"role": "user", "content": [
            {"type": "image", "source": {
                "type": "base64",
                "media_type": "'$IMAGE_MEDIA_TYPE'",
                "data": "'$IMAGE_BASE64'"
            }},
            {"type": "text", "text": "Describe this image"}
        ]}
    ]
}'

JSON

{ "input_tokens": 1551 }

Token in Nachrichten mit erweitertem Denken zählen

Weitere Details zur Berechnung des Kontextfensters mit erweitertem Denken finden Sie hier

Denk-Blöcke aus vorherigen Assistent-Turns werden ignoriert und zählen nicht zu Ihren Input-Token
Aktuelles Assistent-Turn-Denken zählt zu Ihren Input-Token

curl https://api.anthropic.com/v1/messages/count_tokens \
    --header "x-api-key: $ANTHROPIC_API_KEY" \
    --header "content-type: application/json" \
    --header "anthropic-version: 2023-06-01" \
    --data '{
      "model": "claude-sonnet-4-6",
      "thinking": {
        "type": "enabled",
        "budget_tokens": 16000
      },
      "messages": [
        {
          "role": "user",
          "content": "Are there an infinite number of prime numbers such that n mod 4 == 3?"
        },
        {
          "role": "assistant",
          "content": [
            {
              "type": "thinking",
              "thinking": "This is a nice number theory question. Lets think about it step by step...",
              "signature": "EuYBCkQYAiJAgCs1le6/Pol5Z4/JMomVOouGrWdhYNsH3ukzUECbB6iWrSQtsQuRHJID6lWV..."
            },
            {
              "type": "text",
              "text": "Yes, there are infinitely many prime numbers p such that p mod 4 = 3..."
            }
          ]
        },
        {
          "role": "user",
          "content": "Can you write a formal proof?"
        }
      ]
    }'

JSON

{ "input_tokens": 88 }

Token in Nachrichten mit PDFs zählen

Token-Zählung unterstützt PDFs mit den gleichen Einschränkungen wie die Messages API.

curl https://api.anthropic.com/v1/messages/count_tokens \
    --header "x-api-key: $ANTHROPIC_API_KEY" \
    --header "content-type: application/json" \
    --header "anthropic-version: 2023-06-01" \
    --data '{
      "model": "claude-opus-4-6",
      "messages": [{
        "role": "user",
        "content": [
          {
            "type": "document",
            "source": {
              "type": "base64",
              "media_type": "application/pdf",
              "data": "'$(base64 -i document.pdf)'"
            }
          },
          {
            "type": "text",
            "text": "Please summarize this document."
          }
        ]
      }]
    }'

JSON

{ "input_tokens": 2188 }

Preisgestaltung und Rate Limits

Token-Zählung ist kostenlos zu verwenden, unterliegt aber Anfragen pro Minute Rate Limits basierend auf Ihrer Nutzungsstufe. Wenn Sie höhere Limits benötigen, kontaktieren Sie den Vertrieb über die Claude Console.

Nutzungsstufe	Anfragen pro Minute (RPM)
1	100
2	2.000
3	4.000
4	8.000

Token-Zählung und Message-Erstellung haben separate und unabhängige Rate Limits -- die Nutzung einer zählt nicht gegen die Limits der anderen.

Häufig gestellte Fragen

Was this page helpful?

Kontextverwaltung

Token-Zählung

Token-Zählung ermöglicht es Ihnen, die Anzahl der Token in einer Nachricht zu bestimmen, bevor Sie sie an Claude senden.

Proaktiv Rate Limits und Kosten verwalten
Intelligente Modell-Routing-Entscheidungen treffen
Prompts auf eine bestimmte Länge optimieren

This feature is Zero Data Retention (ZDR) eligible. When your organization has a ZDR arrangement, data sent through this feature is not stored after the API response is returned.

So zählen Sie Message-Token

Unterstützte Modelle

Alle aktiven Modelle unterstützen Token-Zählung.

Token in grundlegenden Nachrichten zählen

import anthropic

client = anthropic.Anthropic()

response = client.messages.count_tokens(
    model="claude-opus-4-6",
    system="You are a scientist",
    messages=[{"role": "user", "content": "Hello, Claude"}],
)

print(response.json())

JSON

{ "input_tokens": 14 }

Token in Nachrichten mit Tools zählen

Server Tool Token-Zählungen gelten nur für den ersten Sampling-Aufruf.

import anthropic

client = anthropic.Anthropic()

response = client.messages.count_tokens(
    model="claude-opus-4-6",
    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"],
            },
        }
    ],
    messages=[{"role": "user", "content": "What's the weather like in San Francisco?"}],
)

print(response.json())

JSON

{ "input_tokens": 403 }

Token in Nachrichten mit Bildern zählen

#!/bin/sh

IMAGE_URL="https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg"
IMAGE_MEDIA_TYPE="image/jpeg"
IMAGE_BASE64=$(curl "$IMAGE_URL" | base64)

curl https://api.anthropic.com/v1/messages/count_tokens \
     --header "x-api-key: $ANTHROPIC_API_KEY" \
     --header "anthropic-version: 2023-06-01" \
     --header "content-type: application/json" \
     --data \
'{
    "model": "claude-opus-4-6",
    "messages": [
        {"role": "user", "content": [
            {"type": "image", "source": {
                "type": "base64",
                "media_type": "'$IMAGE_MEDIA_TYPE'",
                "data": "'$IMAGE_BASE64'"
            }},
            {"type": "text", "text": "Describe this image"}
        ]}
    ]
}'

JSON

{ "input_tokens": 1551 }

Token in Nachrichten mit erweitertem Denken zählen

Weitere Details zur Berechnung des Kontextfensters mit erweitertem Denken finden Sie hier

Denk-Blöcke aus vorherigen Assistent-Turns werden ignoriert und zählen nicht zu Ihren Input-Token
Aktuelles Assistent-Turn-Denken zählt zu Ihren Input-Token

curl https://api.anthropic.com/v1/messages/count_tokens \
    --header "x-api-key: $ANTHROPIC_API_KEY" \
    --header "content-type: application/json" \
    --header "anthropic-version: 2023-06-01" \
    --data '{
      "model": "claude-sonnet-4-6",
      "thinking": {
        "type": "enabled",
        "budget_tokens": 16000
      },
      "messages": [
        {
          "role": "user",
          "content": "Are there an infinite number of prime numbers such that n mod 4 == 3?"
        },
        {
          "role": "assistant",
          "content": [
            {
              "type": "thinking",
              "thinking": "This is a nice number theory question. Lets think about it step by step...",
              "signature": "EuYBCkQYAiJAgCs1le6/Pol5Z4/JMomVOouGrWdhYNsH3ukzUECbB6iWrSQtsQuRHJID6lWV..."
            },
            {
              "type": "text",
              "text": "Yes, there are infinitely many prime numbers p such that p mod 4 = 3..."
            }
          ]
        },
        {
          "role": "user",
          "content": "Can you write a formal proof?"
        }
      ]
    }'

JSON

{ "input_tokens": 88 }

Token in Nachrichten mit PDFs zählen

Token-Zählung unterstützt PDFs mit den gleichen Einschränkungen wie die Messages API.

curl https://api.anthropic.com/v1/messages/count_tokens \
    --header "x-api-key: $ANTHROPIC_API_KEY" \
    --header "content-type: application/json" \
    --header "anthropic-version: 2023-06-01" \
    --data '{
      "model": "claude-opus-4-6",
      "messages": [{
        "role": "user",
        "content": [
          {
            "type": "document",
            "source": {
              "type": "base64",
              "media_type": "application/pdf",
              "data": "'$(base64 -i document.pdf)'"
            }
          },
          {
            "type": "text",
            "text": "Please summarize this document."
          }
        ]
      }]
    }'

JSON

{ "input_tokens": 2188 }

Preisgestaltung und Rate Limits

Nutzungsstufe	Anfragen pro Minute (RPM)
1	100
2	2.000
3	4.000
4	8.000

Token-Zählung und Message-Erstellung haben separate und unabhängige Rate Limits -- die Nutzung einer zählt nicht gegen die Limits der anderen.

Häufig gestellte Fragen

Was this page helpful?

So zählen Sie Message-Token

Unterstützte Modelle

Token in grundlegenden Nachrichten zählen

Token in Nachrichten mit Tools zählen

Token in Nachrichten mit Bildern zählen

Token in Nachrichten mit erweitertem Denken zählen

Token in Nachrichten mit PDFs zählen

Preisgestaltung und Rate Limits

Häufig gestellte Fragen

Verwendet Token-Zählung Prompt-Caching?

So zählen Sie Message-Token

Unterstützte Modelle

Token in grundlegenden Nachrichten zählen

Token in Nachrichten mit Tools zählen

Token in Nachrichten mit Bildern zählen

Token in Nachrichten mit erweitertem Denken zählen

Token in Nachrichten mit PDFs zählen

Preisgestaltung und Rate Limits

Häufig gestellte Fragen

Verwendet Token-Zählung Prompt-Caching?