Prezzi e fatturazione
Tutto l’utilizzo dell’API si paga da un unico saldo GeraiPoints (GP). Nessun abbonamento né quota mensile: paghi solo i token che usi davvero.
GeraiPoints
- Ricarica il saldo nella pagina Ricarica. Il saldo non scade.
- La cronologia di utilizzo per richiesta e per chiave è nella Dashboard.
Come si calcola il costo
Il costo di ogni richiesta si calcola dall’usage riportato dal modello, con la tariffa per 1 milione di token di quel modello, e viene arrotondato per eccesso al GP intero.
biaya = ceil(
input_tokens / 1000000 × tarif_input
+ output_tokens / 1000000 × tarif_output
+ cache_read_tokens / 1000000 × tarif_cache_read
+ cache_write_tokens / 1000000 × tarif_cache_write
)
tagihan = max(biaya, minimum_per_request)Esempio con la tariffa attuale di claude-sonnet-5:
| Voce | Valore |
|---|---|
| Tariffa input | 2.300 GP / 1M token |
| Tariffa output | 11.600 GP / 1M token |
| Minimo per richiesta | 50 GP |
| Utilizzo (esempio) | 20.000 input + 1.000 output |
| Importo addebitato | 58 GP |
I valori provengono dal catalogo attuale e possono cambiare; la tariffa ufficiale di ogni modello è nella pagina dei prezzi.
Per token o per richiesta?
Tutti i modelli sono fatturati per token con un piccolo minimo per richiesta. L’eccezione è quando è attiva una promo a tariffa fissa: i modelli contrassegnati dalla promo sono fatturati con un importo fisso per richiesta pari al loro minimo, qualunque sia il numero di token.
Prezzi della cache
I modelli che supportano il prompt caching hanno una tariffa separata per i token letti dalla cache (cache read) e, per alcuni modelli, per i token scritti nella cache (cache write). I token cache read costano molto meno dell’input normale, quindi mantenere lo stesso prefisso del prompt (system prompt, contenuto dei file) fa risparmiare. Le tariffe della cache di ogni modello sono nella pagina dei prezzi.
Minimo per richiesta e controllo del saldo
Ogni modello ha un minimo per richiesta (floor). Le richieste piccole il cui costo in token è sotto il floor vengono fatturate per l’importo del floor: non è un costo aggiuntivo rispetto al costo dei token.
- Prima di inoltrare la richiesta, il server controlla il saldo e riserva il costo stimato. Se il saldo non basta, risponde 402
insufficient_quotasenza alcun addebito. - L’addebito finale si calcola dopo che la risposta è stata inviata completamente, in base all’utilizzo reale.
Richieste annullate
Le richieste annullate dal lato dell’acquirente (timeout dell’app, pulsante di stop, connessione caduta) prima che arrivi la risposta vengono addebitate in base al costo effettivamente applicato dal server di IA, alle tariffe vigenti del modello; non vengono addebitate se il server di IA non addebita nulla. L’addebito iniziale può essere più alto, la differenza torna automaticamente sul saldo. L’output vuoto è compensato solo per problemi dal nostro lato (risposta vuota/errore del server, o nessun output per ≥60 secondi). Si applica dal 1° novembre 2026.
Per non pagare richieste interrotte, imposta un timeout di almeno 300 secondi e attiva lo stream. Le guide per i singoli strumenti sono in Impostazioni degli strumenti agentici.
Quando si paga e quando no
| Caso | Addebitato? |
|---|---|
| Risposta completata | Sì — in base all’utilizzo |
| Errore del nostro server prima che esca la risposta (502/503) | No |
| Rifiutata prima dell’elaborazione (400/401/402/403/404) | No |
| Annullata da parte tua (timeout dell’app, pulsante stop, connessione persa) | Sì — l’utilizzo già avvenuto |
| Nuovi tentativi (retry) automatici | Sì — ogni tentativo è una nuova richiesta |