Questa guida fornisce una panoramica delle diverse opzioni di fatturazione dell'API Gemini, spiega come attivare la fatturazione e monitorare l'utilizzo e fornisce risposte alle domande frequenti sulla fatturazione.
Informazioni su fatturazione e livelli
La fatturazione dell'API Gemini si basa sulla cronologia dei pagamenti.
| Livello di utilizzo | Qualificazione | Limite del livello di fatturazione |
|---|---|---|
| Nessun costo | Progetto attivo o prova senza costi | N/D |
| Livello 1 | Configurare e collegare un account di fatturazione attivo | 250 $ |
| Livello 2 | Pagamento di 100 $+ 3 giorni dal primo pagamento andato a buon fine | $ 2000 |
| Livello 3 | Pagamento di 1000 $+ 30 giorni dal primo pagamento andato a buon fine | 20.000 $-100.000+ $ |
I nuovi account iniziano con il Livello senza costi, che consente l'accesso a determinati modelli nell'API Gemini e in AI Studio, fino ai limiti di frequenza del Livello senza costi dei modelli.
Per accedere a limiti di frequenza più elevati, utilizzare modelli avanzati e assicurarti che i prompt e le risposte non vengano utilizzati per migliorare i prodotti Google*, puoi collegare un account di fatturazione e pagare in anticipo per passare ai Livelli a pagamento. Successivamente, passerai ai livelli superiori in base alla spesa cumulativa e all'età dell'account. Al livello 3, potresti avere la possibilità di passare alla fatturazione postpagamento.
I livelli, i limiti di frequenza e i limiti dell'account di fatturazione sono tutti determinati a livello di account di fatturazione.
* Privacy dei dati di livello aziendale: per saperne di più sull'utilizzo dei dati per i servizi a pagamento, consulta i Termini di servizio.
Configurare la fatturazione per accedere al livello a pagamento
Puoi creare un progetto e configurare la fatturazione o importare un progetto esistente per eseguire l'upgrade al livello a pagamento in Google AI Studio. L'upgrade dal Livello senza costi al Livello a pagamento prevede il collegamento di un account di fatturazione e il pagamento anticipato per aggiungere al tuo account un minimo di 10 $ (o l'equivalente in altre valute) di crediti.
- Vai alla pagina Chiavi API, alla pagina Progetti o in qualsiasi punto in cui vedi il pulsante Configura fatturazione in AI Studio.
- Per i nuovi utenti verranno creati per impostazione predefinita un progetto e una chiave API.
- Se hai bisogno di una nuova chiave, fai clic su Crea chiave API e segui la finestra di dialogo per aggiungere una coppia chiave-progetto alla tabella.
- Individua il progetto del livello senza costi che vuoi eseguire l'upgrade al livello a pagamento e fai clic su Configura fatturazione nella colonna Livello di fatturazione.
- Se non hai mai configurato un account di fatturazione Google:
- Ti verrà chiesto di selezionare il tuo paese per accettare i Termini di servizio.
- Poi, inserisci o conferma i tuoi dati di contatto e il metodo di pagamento per continuare.
- Se in passato hai configurato account di fatturazione Google:
- Ti verrà chiesto di scegliere tra i tuoi account di fatturazione esistenti.
- Se non vuoi utilizzare nessuno dei tuoi account esistenti, fai clic su Aggiungi nuovo account di fatturazione e compila o conferma i tuoi dati di contatto e il metodo di pagamento per continuare.
- Successivamente, potrai:
- Ti è stato chiesto di pagare in anticipo un minimo di 10 $per completare la configurazione della fatturazione (il tuo account viene assegnato automaticamente al piano di fatturazione Prepagato).
- Data la scelta tra i piani di fatturazione prepagato e postpagato per il tuo account.
- Assegnato a un piano di fatturazione postpagamento per un periodo intermedio fino a quando il nuovo sistema prepagato non verrà propagato a tutti gli utenti (a partire dal 23 marzo 2026).
- Dopo aver effettuato il pagamento anticipato o selezionato il pagamento posticipato, la configurazione dell'account è completata.
Eseguire l'upgrade al livello a pagamento successivo
Se hai già un piano a pagamento e soddisfi i criteri per il cambio di piano, verrà eseguito automaticamente l'upgrade al livello successivo (in base ai tempi di elaborazione).
Verificare lo stato della fatturazione
Dopo aver collegato un account di fatturazione al tuo progetto, puoi monitorarne lo stato nella pagina Fatturazione di AI Studio. A differenza del livello senza costi, lo stato del livello a pagamento è dinamico: mentre il livello di utilizzo è determinato dalla cronologia dell'account, l'API Gemini servirà le richieste solo se hai un saldo positivo dei crediti prepagati.
Nella pagina Progetti, potrai visualizzare il livello e il piano di fatturazione del tuo progetto nella colonna Livello di fatturazione. Eventuali azioni relative allo stato di fatturazione che potresti dover intraprendere per un progetto vengono visualizzate nelle colonne Livello di fatturazione o Stato:
- "Configura la fatturazione" se al progetto non è collegato un account di fatturazione.
- "Configura il pagamento anticipato" se il progetto ha un account di fatturazione collegato, ma deve utilizzare un piano di fatturazione pagamento anticipato che deve essere configurato.
- "Nessun credito disponibile" se l'account di fatturazione è tenuto ad acquistare crediti, ma l'account pagamenti prepagato non è configurato o il saldo disponibile è esaurito.
Fai clic su uno dei messaggi per procedere con le azioni necessarie.
Monitorare l'utilizzo
Puoi monitorare l'utilizzo dell'API Gemini in Google AI Studio in Dashboard > Utilizzo.
Piani di fatturazione
I piani di fatturazione per l'API Gemini e AI Studio rientrano in due categorie che determinano quando paghi l'utilizzo: pagamento anticipato e pagamento posticipato. Puoi controllare il piano di fatturazione assegnato e gestire i metodi di pagamento nella pagina Fatturazione di AI Studio.
Pagamento anticipato
Nel piano di fatturazione prepagato, acquisti crediti per il saldo prepagato in anticipo rispetto all'utilizzo dell'API Gemini e i costi di utilizzo dell'API vengono dedotti dal saldo dei crediti prepagati quasi in tempo reale. Puoi pagare in anticipo aggiungendo crediti al tuo account o configurando la ricarica automatica. Una volta acquistati, i crediti non utilizzati scadono dopo 12 mesi e non sono rimborsabili, tranne dopo il passaggio a un account Postpay.
Quando il saldo del credito prepagato dell'account di fatturazione raggiunge 0 $, tutte le chiavi API di tutti i progetti collegati a quell'account di fatturazione smetteranno di funzionare contemporaneamente. I crediti prepagati si applicano solo ai costi di utilizzo dell'API Gemini; non puoi utilizzarli per pagare altri servizi Google Cloud.
Per impostazione predefinita, i nuovi utenti utilizzano il piano di fatturazione prepagato. I progetti precedenti all'introduzione dei piani di fatturazione prepagata e postpagata potrebbero dover aggiornare i dettagli di fatturazione del progetto prima di continuare a utilizzare l'API Gemini.
Acquista crediti
Puoi acquistare manualmente i crediti in anticipo rispetto all'utilizzo dell'API Gemini per caricarli nel saldo del credito dell'account con pagamento anticipato.
Per acquistare crediti, vai alla pagina Fatturazione di AI Studio e seleziona Acquista crediti. L'acquisto minimo è di 10 $. L'importo massimo di crediti che puoi pagare in anticipo è di 5000 $.
Ricarica automaticamente
La ricarica automatica è una funzionalità facoltativa che ricarica automaticamente il saldo dei crediti prepagati quando sta per esaurirsi. Ciò è utile per evitare interruzioni del servizio.
Puoi configurare la ricarica automatica e visualizzare lo stato della ricarica automatica nella scheda Crediti disponibili nella pagina Fatturazione AI Studio. Fai clic su Configura ricarica automatica o Gestisci ricarica automatica per impostare il metodo di pagamento, l'importo della ricarica e il saldo minimo che attiva un pagamento di ricarica.
Pagamento posticipato
Nel piano di fatturazione postpagato, il tuo account Cloud Billing accumula costi e ti vengono addebitati automaticamente alla fine del mese o quando i costi raggiungono un importo soglia assegnato automaticamente. Il pagamento viene addebitato sul metodo di pagamento collegato al tuo account pagamenti Postepay, che puoi gestire nella pagina Fatturazione di AI Studio.
Quando soddisfi i criteri del livello 3, puoi passare manualmente dal piano prepagato a quello postpagato. Per cambiare piano, dovrai fare clic sul pulsante Passa al postpagato visualizzato in alto a destra nella pagina Fatturazione di AI Studio quando il tuo account diventa idoneo.
Nella pagina Fatturazione potrai visualizzare il saldo, le date di scadenza e i pagamenti passati, nonché effettuare pagamenti e gestire i metodi di pagamento.
Quando configuri la fatturazione per un nuovo progetto, se hai l'idoneità per il pagamento posticipato, potrai scegliere tra pagamento anticipato e posticipato nella finestra di dialogo configurazione della fatturazione.
Dopo aver cambiato un account di fatturazione Cloud in modo che utilizzi il piano di fatturazione postpagato, tutti i progetti collegati a quell'account di fatturazione vengono spostati al piano postpagato. Non puoi ripristinare il piano di fatturazione prepagato per questo account di fatturazione. Puoi spostare un progetto in un account di fatturazione con un piano di fatturazione diverso per modificare il ciclo di addebito per quel progetto. Consulta la documentazione di Cloud sulla gestione della fatturazione per i progetti.
Per saperne di più sul ciclo di addebito postpagato, consulta la guida alla fatturazione Cloud.
Limiti di spesa
L'API Gemini supporta i limiti di spesa mensili sia a livello di account di fatturazione sia a livello di progetto. Questi controlli sono progettati per proteggere il tuo account da superamenti imprevisti e l'ecosistema per garantire la disponibilità del servizio.
Limiti di spesa del progetto
Puoi impostare i tuoi limiti di spesa a livello di progetto in AI Studio. Questa funzionalità è utile se hai più progetti nello stesso account di fatturazione e vuoi assicurarti che ognuno abbia accesso a una parte sufficiente del limite di spesa cumulativo.
Gli account con i ruoli di editor, proprietario o amministratore del progetto possono impostare limiti di spesa per progetto in AI Studio nella pagina Spesa in Limite di spesa mensile > Modifica limite di spesa.
Se sposti un progetto in un altro account di fatturazione, il limite di spesa che hai già impostato per quel progetto verrà mantenuto, ma la spesa accumulata verrà reimpostata su 0 € per il nuovo ciclo di fatturazione.
I completamenti in modalità batch potrebbero comunque comportare costi aggiuntivi.
I tempi di elaborazione dei dati di fatturazione possono subire un leggero ritardo in AI Studio, fino a circa 10 minuti. Potresti riscontrare superamenti oltre il limite del progetto se i dati di fatturazione non sono stati elaborati prima dell'accumulo di ulteriori addebiti.
Limiti di spesa dei livelli dell'account di fatturazione
Ogni livello ha un limite di spesa mensile massimo:
| Livello di utilizzo | Limite di spesa |
|---|---|
| Nessun costo | N/D |
| Livello 1 | 250 $ |
| Livello 2 | $ 2000 |
| Livello 3 | 20.000 $-100.000 $ |
I limiti di utilizzo mensile vengono applicati a livello di account di fatturazione, sono preimpostati e non configurabili. La spesa totale viene aggregata in tutti i progetti collegati; quando il totale cumulativo raggiunge il limite del livello, il servizio viene sospeso per tutti i progetti collegati a quell'account di fatturazione fino all'inizio del ciclo di fatturazione successivo (mensile).
Valutare la spesa dell'account di fatturazione
Per valutare la spesa mensile storica e determinare se i nuovi limiti di spesa del livello dell'account di fatturazione influiranno sui tuoi progetti in corso, segui questi passaggi:
- Nella console Google Cloud, visualizza la pagina Report dell'account di fatturazione Cloud.
- Se hai più di un account di fatturazione, quando richiesto scegli l'account di fatturazione Cloud per cui vuoi visualizzare i report sui costi.
- Per impostazione predefinita, il report è impostato su "Raggruppa per servizio" nel "Mese attuale". Vedrai API Gemini nella colonna Servizio e la spesa totale nella colonna Costo utilizzo della tabella.
- Per visualizzare i costi granulari limitati all'utilizzo dell'API Gemini, imposta il filtro Raggruppa per in modo da raggruppare per SKU e il filtro Servizi su API Gemini.
- Modifica il filtro Intervallo di tempo per data di utilizzo in base all'intervallo che preferisci per valutare la spesa storica in un periodo.
Tempi di elaborazione
Gli indicatori e gli aggiornamenti di fatturazione non vengono sempre eseguiti in tempo reale.
- Utilizzo del credito: i costi di utilizzo vengono in genere detratti dal saldo nel giro di pochi minuti.
- Conferma del pagamento: anche se la maggior parte dei pagamenti con carta è immediata, alcune forme di pagamento (come i bonifici bancari) potrebbero richiedere diversi giorni per essere autorizzate. I servizi vengono ripristinati o eseguiti l'upgrade solo dopo la conferma ufficiale dell'acquisto dei crediti.
- Upgrade di livello: dopo un pagamento andato a buon fine o quando soddisfi i criteri di upgrade, gli upgrade di livello vengono in genere visualizzati entro 10 minuti.
- Grafici di suddivisione del costo totale: i grafici che mostrano la suddivisione del costo totale sia nella pagina Fatturazione sia nella pagina Spesa possono richiedere fino a 24 ore per l'aggiornamento.
Per saperne di più sui potenziali ritardi di fatturazione, leggi le guide alla fatturazione Cloud su ciclo di addebito e latenze delle transazioni.
Rimborsi
Non sono consentiti rimborsi per gli account di fatturazione prepagati. I crediti acquistati scadono dopo 1 anno. Dopo la scadenza, i crediti vengono persi e non possono essere recuperati.
Quando un account prepagato passa al tipo di account postpagato (dopo che hai soddisfatto i criteri ed eseguito l'upgrade manuale dell'account), l'account prepagato viene chiuso e l'eventuale credito prepagato residuo viene rimborsato automaticamente sul metodo di pagamento registrato.
Se chiudi il tuo account prepagato per qualsiasi motivo diverso dall'upgrade a Postpagato, i crediti prepagati rimanenti vengono persi.
Gli account postpagamento seguono le norme di rimborso di Google Cloud.
Account di fatturazione Cloud
L'API Gemini utilizza gli account Cloud Billing per i servizi di fatturazione, che puoi configurare direttamente in AI Studio. Puoi utilizzare AI Studio per monitorare la spesa, comprendere i costi ed effettuare pagamenti.
I livelli, i limiti di frequenza e i limiti dell'account di fatturazione sono tutti determinati a livello di account di fatturazione.
Progetti e chiavi API
Tutti i progetti collegati a un account di fatturazione Cloud ereditano il livello di utilizzo e i limiti di velocità e i limiti dell'account associati. Se modifica un progetto da un account di fatturazione a un altro, il suo livello e, di conseguenza, i limiti di frequenza e i limiti dell'account, passeranno al livello del nuovo account di fatturazione.
La spesa cumulativa (per tutti i prodotti Google Cloud) e l'età dell'account in tutti i progetti collegati a un account di fatturazione vengono conteggiate ai fini delle qualifiche per il livello dell'account di fatturazione.
Puoi scollegare un progetto dal relativo account di fatturazione per tornare al livello senza costi.
Le chiavi API sono credenziali generate all'interno di un progetto. Non hanno impostazioni di fatturazione indipendenti; ereditano i limiti del livello e lo stato di fatturazione del progetto. L'utilizzo cumulativo di tutte le chiavi all'interno di un progetto viene conteggiato ai fini del limite di spesa del progetto e della spesa totale dell'account di fatturazione.
Domande frequenti
Le seguenti sezioni forniscono le risposte alle domande frequenti.
A che cosa si riferiscono gli addebiti che ricevo?
I prezzi dell'API Gemini si basano su quanto segue:
- Conteggio token di input
- Conteggio token di output
- Conteggio dei token memorizzati nella cache
- Durata di archiviazione dei token memorizzati nella cache
Per informazioni sui prezzi, consulta la pagina dei prezzi.
Dove posso visualizzare la mia quota?
Puoi visualizzare la quota e i limiti di sistema in AI Studio.
Come faccio a richiedere una quota maggiore?
Ti verrà concessa automaticamente una quota maggiore quando il tuo account raggiungerà i successivi requisiti del livello.
Posso utilizzare l'API Gemini senza costi nel SEE (inclusa l'UE), nel Regno Unito e in Svizzera?
Sì, rendiamo disponibili il livello senza costi e quello a pagamento in molte regioni.
Se configuro la fatturazione con l'API Gemini, mi verrà addebitato l'utilizzo di Google AI Studio?
L'utilizzo di AI Studio rimane senza costi, a meno che gli utenti non colleghino una chiave API a pagamento per accedere alle funzionalità a pagamento. Una volta collegata una chiave API a pagamento nell'ambito di un progetto a pagamento in AI Studio, ti verrà addebitato l'utilizzo di AI Studio per quella chiave. Puoi passare da un progetto del Livello a pagamento a un progetto del Livello senza costi in AI Studio in base alle tue esigenze.
Posso utilizzare 1 milione di token nel livello senza costi?
Il livello senza costi per l'API Gemini varia in base al modello selezionato. Per il momento, puoi provare la finestra contestuale da 1 milione di token nei seguenti modi:
- In Google AI Studio
- Con piani senza costi per modelli selezionati
- Con i piani postpagati
Come faccio a calcolare il numero di token che sto utilizzando?
Utilizza il metodo GenerativeModel.count_tokens
per conteggiare il numero di token. Per saperne di più sui token, consulta la guida ai token.
Posso utilizzare il mio credito di benvenuto di Google Cloud con l'API Gemini?
No, il credito di benvenuto di Google Cloud o il credito della prova senza costi non possono essere utilizzati per l'API Gemini o AI Studio.
Se ti è stato concesso un credito di benvenuto Google Cloud prima che diventasse non idoneo, puoi spendere i crediti rimanenti per l'API Gemini e AI Studio fino alla scadenza dei crediti dopo 90 giorni.
Come viene gestita la fatturazione?
La fatturazione dell'API Gemini viene gestita dal sistema di fatturazione Cloud. Scopri di più sulla configurazione della fatturazione Cloud nel prodotto nella documentazione sulla fatturazione Cloud.
Mi vengono addebitati costi per le richieste non riuscite?
Se la richiesta non va a buon fine e viene visualizzato un errore 400 o 500, non ti verranno addebitati i token utilizzati. Tuttavia, la richiesta verrà comunque conteggiata ai fini del calcolo della quota.
GetTokens è fatturato?
Le richieste all'API GetTokens non vengono fatturate e non vengono conteggiate ai fini della quota di inferenza.
Come vengono gestiti i miei dati di Google AI Studio se ho un account API a pagamento?
Per informazioni dettagliate sul trattamento dei dati quando è abilitata la fatturazione Cloud, consulta i Termini di servizio (vedi "In che modo Google utilizza i tuoi dati" nella sezione "Servizi a pagamento"). Tieni presente che i prompt di Google AI Studio sono trattati ai sensi degli stessi termini dei "Servizi a pagamento" purché almeno un progetto API abbia la fatturazione abilitata, che puoi convalidare nella pagina della chiave API Gemini se vedi progetti contrassegnati come "A pagamento" in "Piano".
Che cosa succede quando il saldo del mio credito prepagato raggiunge 0 €?
Tutti i servizi dell'API Gemini in tutti i progetti pagati da quell'account di fatturazione Cloud prepagato verranno interrotti immediatamente per evitare ulteriori addebiti. I tuoi progetti non vengono automaticamente sottoposti a downgrade al livello senza costi.
Per ripristinare il servizio al tuo attuale livello di piano a pagamento, devi acquistare crediti aggiuntivi. Dopo aver acquistato i crediti, dovresti essere in grado di utilizzare l'API Gemini. Tieni presente che potrebbe verificarsi un ritardo durante l'aggiornamento dei nostri sistemi per riflettere il saldo del credito.
Se vuoi eseguire il downgrade al livello senza costi, puoi disattivare la fatturazione per i progetti per cui vuoi eseguire il downgrade.
I miei crediti prepagati hanno una scadenza?
Sì, i crediti scadono 12 mesi dopo la data di acquisto.
Perché il saldo del credito del mio account prepagato è negativo?
A causa della complessità dei nostri sistemi di fatturazione ed elaborazione, potrebbero verificarsi ritardi nella nostra capacità di interrompere l'utilizzo dopo che hai consumato tutti i tuoi crediti. Questo utilizzo in eccesso potrebbe essere visualizzato come saldo del credito negativo nella dashboard di fatturazione di AI Studio. In questo caso, il servizio viene messo in pausa e il saldo negativo verrà detratto dal tuo prossimo acquisto di crediti.
Per evitare una pausa nel servizio API Gemini, ti consigliamo di configurare la ricarica automatica per acquistare automaticamente altri crediti quando il saldo scende al di sotto di un valore specificato.
Posso utilizzare i miei crediti prepagati per altri servizi Google Cloud, come Vertex AI?
No, i crediti prepagati sono strettamente legati all'utilizzo dell'API Gemini. Qualsiasi altro servizio Google Cloud che utilizzi (Compute, Storage, Vertex) viene fatturato utilizzando il ciclo di addebito standard di Cloud.
Perché visualizzo il messaggio "Il tipo di account di fatturazione è inattivo o non supportato"?
Le interazioni di pagamento nella pagina Fatturazione di AI Studio potrebbero essere bloccate e sostituite dal messaggio "Il tipo di account di fatturazione è inattivo o non supportato" se il tipo di account di fatturazione o lo stato dell'account di fatturazione selezionato non è idoneo per il livello a pagamento in AI Studio.
Controlla la console Google Cloud per visualizzare lo stato del tuo account di fatturazione. Un tipo non idoneo potrebbe essere Account di prova senza costi, nel qual caso puoi attivare la fatturazione in AI Studio per diventare idoneo. Uno stato inattivo potrebbe essere Chiuso, nel qual caso puoi riaprire l'account.
Dove posso ricevere assistenza per la fatturazione?
Per ricevere assistenza in merito alla fatturazione, consulta la pagina Richiedi assistenza per la fatturazione Cloud.