Conteggio token

CostruisciGestione 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 l'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 prompt di sistema, strumenti, immagini e 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 leggermente.

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

client = anthropic.Anthropic()

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

print(response.json())

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.

client = anthropic.Anthropic()

response = client.messages.count_tokens(
    model="claude-opus-4-7",
    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())

Output

{ "input_tokens": 403 }

Contare i token nei messaggi con immagini

import base64
import httpx

image_url = "https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg"
image_media_type = "image/jpeg"
image_data = base64.standard_b64encode(httpx.get(image_url).content).decode("utf-8")

client = anthropic.Anthropic()

response = client.messages.count_tokens(
    model="claude-opus-4-7",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image_media_type,
                        "data": image_data,
                    },
                },
                {"type": "text", "text": "Describe this image"},
            ],
        }
    ],
)
print(response.json())

Output

{ "input_tokens": 1551 }

Contare i token nei messaggi con il pensiero esteso

Vedi come viene calcolata la finestra di contesto 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

client = anthropic.Anthropic()

response = client.messages.count_tokens(
    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. Let's 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?"},
    ],
)

print(response.json())

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.

import base64
import anthropic

client = anthropic.Anthropic()

with open("document.pdf", "rb") as pdf_file:
    pdf_base64 = base64.standard_b64encode(pdf_file.read()).decode("utf-8")

response = client.messages.count_tokens(
    model="claude-opus-4-7",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "document",
                    "source": {
                        "type": "base64",
                        "media_type": "application/pdf",
                        "data": pdf_base64,
                    },
                },
                {"type": "text", "text": "Please summarize this document."},
            ],
        }
    ],
)

print(response.json())

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?

CostruisciGestione del contesto

Conteggio dei token

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

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

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 leggermente.

Modelli supportati

Tutti i modelli attivi supportano il conteggio dei token.

Contare i token nei messaggi di base

client = anthropic.Anthropic()

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

print(response.json())

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.

client = anthropic.Anthropic()

response = client.messages.count_tokens(
    model="claude-opus-4-7",
    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())

Output

{ "input_tokens": 403 }

Contare i token nei messaggi con immagini

import base64
import httpx

image_url = "https://upload.wikimedia.org/wikipedia/commons/a/a7/Camponotus_flavomarginatus_ant.jpg"
image_media_type = "image/jpeg"
image_data = base64.standard_b64encode(httpx.get(image_url).content).decode("utf-8")

client = anthropic.Anthropic()

response = client.messages.count_tokens(
    model="claude-opus-4-7",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "image",
                    "source": {
                        "type": "base64",
                        "media_type": image_media_type,
                        "data": image_data,
                    },
                },
                {"type": "text", "text": "Describe this image"},
            ],
        }
    ],
)
print(response.json())

Output

{ "input_tokens": 1551 }

Contare i token nei messaggi con il pensiero esteso

Vedi come viene calcolata la finestra di contesto 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

client = anthropic.Anthropic()

response = client.messages.count_tokens(
    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. Let's 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?"},
    ],
)

print(response.json())

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.

import base64
import anthropic

client = anthropic.Anthropic()

with open("document.pdf", "rb") as pdf_file:
    pdf_base64 = base64.standard_b64encode(pdf_file.read()).decode("utf-8")

response = client.messages.count_tokens(
    model="claude-opus-4-7",
    messages=[
        {
            "role": "user",
            "content": [
                {
                    "type": "document",
                    "source": {
                        "type": "base64",
                        "media_type": "application/pdf",
                        "data": pdf_base64,
                    },
                },
                {"type": "text", "text": "Please summarize this document."},
            ],
        }
    ],
)

print(response.json())

Output

{ "input_tokens": 2188 }

Prezzi e limiti di velocità

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?

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?