Quattro tipi di token
In questa pagina
Comprendere la fatturazione dei token
Una fattura dell’API Grok non è semplicemente volume per prezzo. Coesistono quattro tipi di token, ognuno con le proprie regole di conteggio e tariffa; due applicazioni che consumano lo stesso numero totale di token possono pagare importi molto diversi. Leggere questa scomposizione è essenziale per stimare un budget prima del lancio e per capire, una volta in produzione, da dove proviene una voce di spesa fuori controllo.
Token di testo e il divario input-output
I token di testo costituiscono la maggior parte del volume: tutto ciò che invii (prompt di sistema, cronologia conversazione, messaggio utente) e tutto ciò che il modello produce in risposta. Su grok-4.5, l’input è fatturato a 2,00 $ per milione di token e l’output a 6,00 $ per milione. Su grok-4.3, questi valori scendono rispettivamente a 1,25 $ e 2,50 $ per milione.
Ricorda la forma del rapporto: l’output costa sempre più dell’input, di un fattore tre su grok-4.5. Generare testo richiede più potenza di calcolo rispetto alla lettura del contesto e la griglia dei prezzi riflette questa asimmetria. La conseguenza pratica è controintuitiva: aggiungere mille token di esempi al tuo prompt di sistema spesso costa meno che lasciare che il modello produca mille token di verbosità superflua. Un’istruzione di concisione ben posizionata è talvolta la leva di risparmio migliore in un’intera applicazione.
Token immagine
Un’immagine inviata all’API viene convertita in token prima dell’analisi. Il conteggio varia da 256 token per una miniatura a bassa risoluzione a 1.792 token per un’immagine ad alta definizione, a seconda delle dimensioni e del livello di dettaglio. Questi token sono fatturati alla tariffa di input testuale, il che rende facile inquadrare il compromesso: ogni immagine pesante equivale, sulla tua fattura, a circa millecinquecento parole di prompt.
Integra quindi questo riflesso nella pipeline a monte della chiamata. Ridimensiona sistematicamente alla risoluzione minima richiesta dal tuo caso d’uso, applica una compressione JPEG ragionevole e smetti di inviare immagini 4K quando un’immagine standard basta a rispondere alla domanda. Su un servizio che elabora migliaia di foto al giorno, questo semplice ridimensionamento taglia la fattura visiva senza degradare la qualità della risposta. Nota i vincoli di formato lungo il percorso: sono accettati solo JPG e PNG, fino a 20 MiB per file.
Token in cache
I token in cache sono token di input che il sistema di cache automatico dell’API ha già memorizzato durante una chiamata precedente. Sono fatturati a una tariffa fortemente ridotta: 0,30 $ per milione su grok-4.5 invece di 2,00 $ (circa l’85% di risparmio) e 0,20 $ per milione su grok-4.3 invece di 1,25 $.
Il meccanismo che attiva questa cache sarà trattato nella prossima sezione del corso. Per ora, sappi solo dove leggerlo: il campo cached_tokens nell’oggetto usage restituito con ogni risposta ti dice quanti dei tuoi token di input hanno beneficiato della tariffa ridotta. Questa è la prima metrica da strumentare se vuoi gestire seriamente i tuoi costi.
Token di ragionamento
Il quarto tipo riguarda i modelli che pensano prima di rispondere, come la variante grok-4.20-0309-reasoning. I token di ragionamento corrispondono a questa deliberazione interna, prodotta prima della risposta visibile.
È qui che si nasconde la sorpresa di fatturazione più frequente: questi token sono conteggiati alla tariffa di output, non di input. Su grok-4.5, ciò rappresenta 6,00 $ per milione. Poiché il ragionamento può mobilitare diverse migliaia di token su una domanda complessa, la parte invisibile della risposta supera talvolta quella visibile. Aggiungi un dettaglio che spesso confonde i team: grok-4.20-0309 non restituisce il contenuto del ragionamento (reasoning_content) in chiaro nella risposta API. Paghi per una catena di pensiero che non puoi leggere. Non è un motivo per escludere il ragionamento, ma un motivo per abilitarlo solo dove cambia davvero la qualità del risultato.
Prezzi al 5 agosto 2026 — i prezzi evolvono regolarmente: prima di qualsiasi calcolo di budget, verifica la griglia attuale sulla pagina ufficiale dei modelli e dei prezzi xAI.
Punti chiave
- Esistono quattro tipi di token: testo, immagine, cache (tariffa ridotta) e ragionamento (fatturato come output)
- I token immagine variano da 256 a 1.792 a seconda delle dimensioni e del dettaglio dell’immagine
- I token in cache offrono circa l’85% di risparmio su grok-4.5
- I token di ragionamento sono fatturati alla tariffa di output, il che può rappresentare un costo significativo
- Scegli il modello giusto per il tuo bisogno: grok-4.3 costa significativamente meno di grok-4.5, sia per l’input che per l’output