Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Quattro tipi di token

Lezione 5 di 14 Aggiornata il 29 luglio 2026 Avanzato
In questa pagina
  1. Comprendere la fatturazione dei token
  2. Token di testo e il divario input-output
  3. Token immagine
  4. Token in cache
  5. Token di ragionamento
  6. Punti chiave

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.

4
Tipi di token
85%
Risparmio sui token in cache
1.792
Token massimi per immagine
1M
Contesto massimo

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