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 | Registrazione | N/D |
| Livello 1 | 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 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 per passare ai livelli a pagamento. Passerai ai livelli superiori in base alla spesa cumulativa e all'età dell'account. Puoi sempre scollegare le singole chiavi API per ripristinare la quota senza costi di AI Studio.
* Privacy dei dati di livello aziendale: per ulteriori informazioni 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 direttamente in Google AI Studio senza passare alla console Google Cloud. Otterrai immediatamente lo stato di fatturazione senza costi iniziali e pagherai in un secondo momento solo le risorse specifiche che consumi durante il ciclo di fatturazione (per ulteriori informazioni, consulta la sezione Configurazione della fatturazione automatica di Cloud).
- Vai alla pagina Chiavi API di AI Studio (o in qualsiasi punto di AI Studio in cui vedi "Configura la fatturazione").
- Per i nuovi utenti verranno creati un progetto e una chiave API per impostazione predefinita.
- 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.
- Trova il progetto per il quale vuoi eseguire l'upgrade al livello a pagamento e fai clic su Configura fatturazione nella colonna Livello quota.
- Se un progetto è già in un livello a pagamento, potresti visualizzare l'opzione Esegui l'upgrade.
- La configurazione varia per gli utenti nuovi ed esistenti di Cloud Billing:
Nuovi utenti
Questo flusso di lavoro è destinato agli utenti che non hanno account di fatturazione Google esistenti.
- Segui i passaggi per scegliere il progetto e la chiave API per la configurazione.
- Seleziona il tuo paese per accettare i Termini di servizio nella finestra Configura il tuo account di fatturazione Google Cloud.
- Se hai profili pagamenti esistenti collegati al tuo account, vedrai i tuoi dati di contatto e il metodo di pagamento compilati nella finestra Aggiungi i dettagli dell'account di fatturazione. Fai clic su Modifica per modificare uno dei due campi.
- Se non hai un profilo pagamenti esistente, fai clic sul pulsante + sia per Dati di contatto che per Metodo di pagamento e segui le istruzioni per inserire i tuoi dati nelle rispettive finestre.
- Fai clic su Termina configurazione account.
- Nella finestra successiva verranno visualizzate informazioni sullo stato di fatturazione.
Utenti esistenti
Questo flusso di lavoro è destinato agli utenti che hanno già configurato la fatturazione Google con il proprio account.
- Segui i passaggi per scegliere il progetto e la chiave API per la configurazione.
- Nella finestra Configura il tuo account di fatturazione Cloud avrai diverse opzioni:
- Se disponi di più account di fatturazione, fai clic sul menu Seleziona account di fatturazione per scegliere quello che vuoi collegare al progetto selezionato.
- Se hai un solo account di fatturazione, questo verrà selezionato automaticamente nel menu.
- Se non vuoi utilizzare nessuno dei tuoi account esistenti, fai clic su Aggiungi nuovo account di fatturazione nel menu. Verrà attivato il passaggio 3 della sezione Nuovi utenti della fatturazione Cloud.
- Fai clic su Termina configurazione.
- Nella finestra successiva verranno visualizzate informazioni sullo stato di fatturazione.
Eseguire l'upgrade al livello a pagamento successivo
Se hai già sottoscritto un Livello a pagamento e soddisfi i criteri per il cambio di piano, verrà eseguito automaticamente l'upgrade al livello successivo.
Verificare lo stato della fatturazione
Dopo aver configurato la fatturazione per il livello a pagamento, riceverai immediatamente una notifica che ti informa se la configurazione è andata a buon fine. Puoi anche verificare che il tuo progetto Google Cloud sia collegato all'account di fatturazione Google Cloud e pronto per l'utilizzo a pagamento nella pagina delle chiavi API. Lo stato di fatturazione della chiave nella colonna Livello di quota potrebbe mostrare:
- Livello 1, 2 o 3: verifica che il progetto sia collegato e immediatamente fatturabile.
- Azione necessaria: devi intervenire sul tuo account, ad esempio pagare una fattura, aggiornare un metodo di pagamento e così via.
Monitorare l'utilizzo
Puoi monitorare l'utilizzo dell'API Gemini in Google AI Studio in Dashboard > Utilizzo.
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 sia il tuo account da addebiti imprevisti sia 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 opzione è 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.
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; una volta che il totale cumulativo raggiunge il limite del livello, il servizio viene sospeso per tutti i progetti nell'account 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:
- Vai alla pagina Gestione account di fatturazione in Cloud Console.
- La dashboard Panoramica dell'account di fatturazione mostra il costo totale nel mese corrente. Fai clic su Visualizza dettagli nei report in fondo alla finestra.
- 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 di utilizzo della tabella.
- Modifica il filtro Intervallo di tempo per data di utilizzo in base all'intervallo che preferisci per valutare la spesa storica in un periodo.
Fatturazione Cloud
L'API Gemini utilizza Cloud Billing per gli account di fatturazione, che puoi configurare direttamente in AI Studio. Puoi utilizzare AI Studio per monitorare la spesa e comprendere i costi. Puoi accedere alle stesse informazioni ed effettuare pagamenti nel tuo account di fatturazione Cloud.
Progetti e chiavi API
Puoi creare fino a 10 progetti in un unico account di fatturazione e un progetto può collegare fino a 5 chiavi API.
I livelli di utilizzo si applicano a livello di account di fatturazione. Tutti i progetti di un account di fatturazione ereditano il livello di quota e i limiti associati. La spesa cumulativa e l'età dell'account in tutti i progetti collegati a un account di fatturazione vengono conteggiate ai fini delle qualifiche per il livello.
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 o nella console Google Cloud.
Come faccio a richiedere una quota maggiore?
Per richiedere un aumento del limite di frequenza di un livello a pagamento, utilizza questo modulo.
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 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 i piani con pagamento a consumo
- Con piani senza costi per modelli selezionati
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 di 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 automatica della fatturazione 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".
Dove posso ricevere assistenza per la fatturazione?
Per ricevere assistenza in merito alla fatturazione, consulta la pagina Richiedi assistenza per la fatturazione Cloud.