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

​
Processo di richiesta

Per utilizzare Claude Messages Count Tokens API, puoi prima andare alla pagina Claude Messages Count Tokens API e cliccare sul pulsante “Acquire” per ottenere le credenziali necessarie per la richiesta. Se non sei ancora loggato o registrato, verrai automaticamente reindirizzato alla pagina di accesso che ti invita a registrarti e accedere; dopo aver effettuato il login o la registrazione, verrai automaticamente riportato alla pagina corrente. Questa API è completamente gratuita e non consuma quota.

​
Utilizzo di base

Il percorso di richiesta per Claude Messages Count Tokens API è /v1/messages/count_tokens, mantenendo la coerenza con l’API ufficiale di Anthropic. Dobbiamo fornire almeno due parametri obbligatori:
  • model: seleziona il modello Claude da utilizzare, come claude-sonnet-4-5-20250929, claude-opus-4-20250514, ecc.
  • messages: array di messaggi di input, ogni messaggio contiene role (ruolo) e content (contenuto).
Parametri opzionali comuni:
  • system: messaggio di sistema, che verrà conteggiato nei Token.
  • tools: definizione degli strumenti, che verrà conteggiata nei Token.
  • thinking: configurazione di pensiero esteso.

​
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-sonnet-4-5-20250929",
    "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-sonnet-4-5-20250929",
    "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 di Anthropic

Claude Messages Count Tokens API è completamente compatibile con l’SDK ufficiale di Anthropic e può essere chiamato direttamente utilizzando la libreria anthropic. 
from anthropic import Anthropic

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

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

​
Conteggio dei Token con strumenti inclusi

Se la tua richiesta include definizioni di strumenti, questi strumenti verranno conteggiati nei Token: 
result = client.messages.count_tokens(
    model="claude-sonnet-4-5-20250929",
    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 messaggi di sistema inclusi

I messaggi di sistema verranno anch’essi conteggiati nei Token: 
result = client.messages.count_tokens(
    model="claude-sonnet-4-5-20250929",
    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 di input e non genera alcun output dal modello.
  • I risultati del conteggio dei Token possono essere utilizzati per stimare i costi di chiamata all’API di Claude Messages.
  • Il modo in cui i Token vengono elaborati può variare tra i diversi modelli, si prega di utilizzare lo stesso parametro model utilizzato nelle chiamate effettive.
  • Questa API è completamente gratuita e non consuma alcuna quota.