Richiesta e utilizzo dell'API Claude Messages Count Tokens

L’API Claude Messages Count Tokens può calcolare il numero di Token in input di un Message senza creare effettivamente un messaggio, inclusi i conteggi dei Token per strumenti, immagini e documenti. Questo è molto utile quando è necessario stimare i costi o verificare se l’input supera i limiti del contesto del modello. Questo documento presenta principalmente il processo di utilizzo dell’API Claude Messages Count Tokens.

Processo di richiesta

Per utilizzare l’API Claude Messages Count Tokens, innanzitutto vai alla console Ace Data Cloud per ottenere il tuo API Token e conservarlo come riserva.

Se non hai ancora effettuato l’accesso o la registrazione, verrai automaticamente reindirizzato alla pagina di accesso per registrarti e accedere; al termine, tornerai automaticamente alla pagina corrente. Un solo API Token può chiamare tutti i servizi della piattaforma, senza doverne richiedere uno separatamente per ciascun servizio. La prima richiesta include un credito gratuito, che consente di provarlo gratuitamente; quando il credito è insufficiente, puoi ricaricare il saldo universale nella console.

📘 Documentazione completa: Claude Messages Count Tokens API →

Utilizzo di base

Il percorso di richiesta dell’API Claude Messages Count Tokens è /v1/messages/count_tokens, coerente con l’API ufficiale di Anthropic. Dobbiamo fornire almeno due parametri obbligatori:

model: seleziona il modello Claude da utilizzare; claude-opus-5-5 può essere utilizzato per Messages Token Count, come il più recente modello di punta claude-fable-5-1; il precedente claude-fable-5 rimane compatibile e disponibile. claude-sonnet-5-5 è stato aggiunto all’interfaccia nativa della serie Messages, supportando l’input di immagini e il pensiero adattivo; i suoi prezzi di riferimento ufficiali per input, output e lettura della cache sono rispettivamente 2, 10 e 0,20 dollari per milione di Token.
messages: array di messaggi in input, in cui ogni messaggio include role (ruolo) e content (contenuto).

Parametri opzionali comuni:

system: prompt di sistema, che verrà incluso nel numero di Token.
tools: definizioni degli strumenti, che verranno incluse nel numero di Token.
thinking: configurazione del pensiero esteso.
tool_choice: configurazione della selezione dello strumento.
cache_control: configurazione del controllo della cache a livello superiore o di blocco di contenuto.

messages, system, la riproduzione delle chiamate degli strumenti, le immagini URL e i blocchi di contenuto document/PDF utilizzano la stessa struttura di richiesta stabile dell’API Messages.

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

Esempio 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())

Esempio di risultato restituito:

{
  "input_tokens": 11
}

Utilizzo dell’SDK Anthropic

L’API Claude Messages Count Tokens accetta la struttura di richiesta stabile dell’SDK Anthropic e può essere chiamata tramite la libreria anthropic. L’interfaccia utilizza la capacità nativa Count Tokens corrispondente al modello selezionato per calcolare l’input e può essere utilizzata per verificare la dimensione dell’input prima di inviare una richiesta 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)

Conteggio dei Token con strumenti inclusi

Se la tua richiesta include definizioni di strumenti, anche questi strumenti verranno inclusi nel numero di 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)

Conteggio dei Token con prompt di sistema incluso

Anche il prompt di sistema verrà incluso nel numero di 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)

Note

Questa API calcola solo il numero di Token in input e non produrrà alcun output del modello.
Il risultato del conteggio dei Token può essere utilizzato per stimare la dimensione dell’input e verificare la finestra di contesto; la fatturazione finale si basa sul valore usage nella risposta Messages effettiva.
Immagini, PDF, definizioni degli strumenti, prompt di sistema e configurazione thinking verranno inclusi nel risultato secondo le regole di input del modello selezionato.
Questa API è completamente gratuita e non consuma alcun credito.

Inizia

Chat AI

Immagine AI

Video AI

Audio AI

Web e Dati

CAPTCHA

Identità

Coding

Altre guide

Richiesta e utilizzo dell'API Claude Messages Count Tokens

Processo di richiesta

Utilizzo di base

Esempio cURL

Esempio Python

Utilizzo dell’SDK Anthropic

Conteggio dei Token con strumenti inclusi

Conteggio dei Token con prompt di sistema incluso

Note

​Processo di richiesta

​Utilizzo di base

​Esempio cURL

​Esempio Python

​Utilizzo dell’SDK Anthropic

​Conteggio dei Token con strumenti inclusi

​Conteggio dei Token con prompt di sistema incluso

​Note

Processo di richiesta

Utilizzo di base

Esempio cURL

Esempio Python

Utilizzo dell’SDK Anthropic

Conteggio dei Token con strumenti inclusi

Conteggio dei Token con prompt di sistema incluso

Note