# Come contare i token Gemini

Gemini espone il metodo countTokens, che permette di calcolare i token dell'input prima di generare una risposta.

[Versione HTML](https://www.tokenometro.it/guide/contare-token-gemini/)

Un progetto di YADA Digital. Metodo e limiti: https://www.tokenometro.it/metodologia/
Fonti verificate il: 2026-10-03

## Usa il metodo per il modello scelto

Google documenta il conteggio preventivo dei token per Gemini. Nel Google Gen AI SDK il metodo client.models.count_tokens riceve il modello e il contenuto da misurare. Serve a conoscere la dimensione dell'input; non calcola in anticipo la lunghezza della risposta che verrà prodotta.

Prepara quindi lo stesso contenuto che userai nella generazione. Se conti una domanda breve e poi invii anche un documento, il primo valore non descrive più la richiesta reale. Conserva l'identificatore del modello insieme al risultato. Quando confronti modelli diversi, ripeti la misura per ognuno anziché assumere che la stessa quantità di testo abbia sempre la medesima rappresentazione.

## Testo, file e altri contenuti

Un input Gemini può contenere modalità diverse, secondo ciò che supporta il modello e l'endpoint. Per immagini, audio o video non puoi dedurre i token dal numero di caratteri del nome del file. Usa i percorsi di conteggio documentati per quel contenuto e verifica le opzioni applicabili.

Immagina di analizzare una presentazione con grafici: contare soltanto il testo estratto è una misura parziale se nella richiesta reale includerai anche le pagine come immagini. Scegli il formato in base al compito. Se ti servono relazioni visive, perderle per ottenere un conteggio più basso potrebbe peggiorare il risultato e costringerti a una seconda elaborazione.

## Confrontare preventivo e consumo

Dopo una generazione, conserva i metadati di uso restituiti dall'API adottata. I nomi dei campi e la loro organizzazione vanno letti nella documentazione della versione effettiva: non copiare automaticamente un esempio relativo a un altro endpoint o a un altro SDK.

Per una verifica semplice, registra il conteggio preventivo e poi le quantità dichiarate per input, output e componenti aggiuntive disponibili. Affianca l'esito della risposta, soprattutto se viene interrotta. Tieni il totale distinto dai suoi dettagli per evitare somme duplicate. Questo registro è più utile di un singolo screenshot del contatore, perché rende possibile ricostruire la richiesta e controllare come cambiano i risultati nel tempo.

## Ridurre la dimensione con criterio

Prepara una richiesta campione con un obiettivo preciso e togli soltanto contenuti non pertinenti. Se devi confrontare due pagine, inviare l'intero archivio potrebbe essere superfluo. Se devi trovare un passaggio nel contesto di un documento, conserva invece i riferimenti necessari a interpretarlo correttamente.

Ripeti il conteggio dopo ogni modifica rilevante e verifica la qualità su più domande. Per contenuti riutilizzati spesso, valuta separatamente il context caching: una parte servita dalla cache continua a essere contesto per il modello. Concludi la valutazione con tre dati distinti: dimensione dell'input, consumo osservato e risultato del compito. Mantenere chiara questa distinzione evita di presentare un input più piccolo come un miglioramento quando ha semplicemente escluso le informazioni necessarie.

## Fonti

- [Google · Gemini tokens](https://ai.google.dev/gemini-api/docs/tokens)
- [Google · Context caching](https://ai.google.dev/gemini-api/docs/caching)

## Letture correlate

- [Come contare i token di un testo](https://www.tokenometro.it/guide/come-contare-token-ai/index.md)
- [Come funziona il context caching Gemini](https://www.tokenometro.it/guide/context-caching-gemini/index.md)
- [Cos'è la context window](https://www.tokenometro.it/guide/context-window-cose/index.md)
