> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Messages Count Tokens API richiesta e utilizzo

> Claude AI 集成指南 - XHuoAPI

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](https://api.xhuoapi.ai/documents/claude-messages-count-tokens) 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

```bash theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/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

```python theme={null}
import httpx

url = "https://api.xhuoapi.ai/v1/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:

```json theme={null}
{
  "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`.

```python theme={null}
from anthropic import Anthropic

client = Anthropic(
    api_key="{token}",
    base_url="https://api.xhuoapi.ai/v1",
)

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:

```python theme={null}
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:

```python theme={null}
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.