Gestione del contesto

Conteggio dei token

Determina il numero di token in un messaggio prima di inviarlo a Claude

Il conteggio dei token ti consente di determinare il numero di token in un messaggio prima di inviarlo a Claude, aiutandoti a prendere decisioni consapevoli sui tuoi prompt e sull'utilizzo. Con il conteggio dei token, puoi

Gestire proattivamente i limiti di velocità e i costi
Prendere decisioni intelligenti sul routing dei modelli
Ottimizzare i prompt per una lunghezza specifica

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

Come contare i token dei messaggi

L'endpoint conteggio dei token accetta lo stesso elenco strutturato di input per la creazione di un messaggio, incluso il supporto per i prompt di sistema, gli strumenti, le immagini e i PDF. La risposta contiene il numero totale di token di input.

Il conteggio dei token deve essere considerato una stima. In alcuni casi, il numero effettivo di token di input utilizzati durante la creazione di un messaggio potrebbe differire di una piccola quantità.

I conteggi dei token possono includere token aggiunti automaticamente da Anthropic per ottimizzazioni di sistema. Non ti viene addebitato per i token aggiunti dal sistema. La fatturazione riflette solo il tuo contenuto.

Modelli supportati

Tutti i modelli attivi supportano il conteggio dei token.

Contare i token nei messaggi di base

Output

{ "input_tokens": 14 }

Contare i token nei messaggi con strumenti

I conteggi dei token dello strumento server si applicano solo alla prima chiamata di campionamento.

Output

{ "input_tokens": 403 }

Contare i token nei messaggi con immagini

Output

{ "input_tokens": 1551 }

Contare i token nei messaggi con il pensiero esteso

Vedi come la finestra di contesto viene calcolata con il pensiero esteso per ulteriori dettagli

I blocchi di pensiero dai turni dell'assistente precedenti vengono ignorati e non contano verso i tuoi token di input
Il pensiero del turno dell'assistente attuale conta verso i tuoi token di input

Output

{ "input_tokens": 88 }

Contare i token nei messaggi con PDF

Il conteggio dei token supporta i PDF con le stesse limitazioni dell'API Messages.

Output

{ "input_tokens": 2188 }

Prezzi e limiti di velocità

Il conteggio dei token è gratuito ma soggetto ai limiti di velocità delle richieste al minuto in base al tuo livello di utilizzo. Se hai bisogno di limiti più elevati, contatta il team di vendita tramite la Claude Console.

Livello di utilizzo	Richieste al minuto (RPM)
1	100
2	2.000
3	4.000
4	8.000

Il conteggio dei token e la creazione dei messaggi hanno limiti di velocità separati e indipendenti. L'utilizzo di uno non conta rispetto ai limiti dell'altro.

Domande frequenti

Was this page helpful?

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",
      "system": "You are a scientist",
      "messages": [{
        "role": "user",
        "content": "Hello, Claude"
      }]
    }'

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",
      "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?"
        }
      ]
    }'

#!/bin/sh

IMAGE_URL="https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg"
IMAGE_MEDIA_TYPE="image/jpeg"
IMAGE_BASE64=$(curl -s "$IMAGE_URL" | base64 | tr -d '\n')

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 @- <<EOF
{
    "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"}
        ]}
    ]
}
EOF

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?"
        }
      ]
    }'

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 @- <<EOF
{
  "model": "claude-opus-4-6",
  "messages": [{
    "role": "user",
    "content": [
      {
        "type": "document",
        "source": {
          "type": "base64",
          "media_type": "application/pdf",
          "data": "$PDF_BASE64"
        }
      },
      {
        "type": "text",
        "text": "Please summarize this document."
      }
    ]
  }]
}
EOF

Come contare i token dei messaggi

Modelli supportati

Contare i token nei messaggi di base

Contare i token nei messaggi con strumenti

Contare i token nei messaggi con immagini

Contare i token nei messaggi con il pensiero esteso

Contare i token nei messaggi con PDF

Prezzi e limiti di velocità

Domande frequenti

Il conteggio dei token utilizza la memorizzazione nella cache dei prompt?

Come contare i token dei messaggi

Modelli supportati

Contare i token nei messaggi di base

Contare i token nei messaggi con strumenti

Contare i token nei messaggi con immagini

Contare i token nei messaggi con il pensiero esteso

Contare i token nei messaggi con PDF

Prezzi e limiti di velocità

Domande frequenti

Il conteggio dei token utilizza la memorizzazione nella cache dei prompt?