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 su due livelli di prezzo: il livello senza costi e il livello a pagamento (pagamento a consumo o pagamento solo per l'utilizzo effettivo). Il livello senza costi è disponibile per alcuni modelli, documentati nella pagina Prezzi. I prezzi e i limiti di frequenza variano in base ai livelli e ai modelli.
Google AI Studio offre anche un utilizzo senza costi fino a un limite per alcuni modelli, separato dal Livello senza costi dell'API. Per accedere a modelli e funzionalità solo a pagamento in AI Studio, puoi collegare una chiave API a pagamento. Puoi scollegare una chiave API per tornare alla quota di AIS senza costi.
Perché utilizzare il livello a pagamento?
L'upgrade al livello a pagamento ti consente di accedere a limiti di frequenza più elevati, utilizzare modelli avanzati e garantisce che i tuoi prompt e le tue risposte non vengano utilizzati per migliorare i prodotti Google (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 fatturabile 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 configurazione automatica della fatturazione Cloud).
- Vai alla pagina Chiavi API di AI Studio (o ovunque vedi "Configura la fatturazione" in AI Studio).
- Per impostazione predefinita, per i nuovi utenti vengono creati 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.
- 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 + per Dati di contatto e 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à un livello a pagamento e soddisfi i criteri per la modifica del piano, vai alla pagina Chiavi API AI Studio e seleziona Upgrade nella colonna Livello di quota della riga del progetto chiave in cui è disponibile.
Il sistema verificherà automaticamente l'idoneità del tuo progetto. Se il tuo progetto soddisfa tutti i requisiti, verrà eseguito l'upgrade immediato 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 tuo progetto sia collegato e immediatamente fatturabile.
- Azione richiesta: devi inviare un pagamento anticipato una tantum che si applica all'utilizzo del tuo account.
Verifica del pagamento anticipato una tantum
Google potrebbe richiedere un pagamento anticipato una tantum per attivare il livello a pagamento dell'API Gemini. Questa misura contribuisce a mantenere la sicurezza e la disponibilità della nostra piattaforma per tutti gli utenti. Non si tratta di una commissione, ma di un credito applicato direttamente al tuo account per un utilizzo futuro.
Procedura di pagamento anticipato
- Configura la fatturazione: quando attivi l'API Gemini in un progetto collegato a un account di fatturazione idoneo, ti invieremo una notifica se è richiesto un pagamento anticipato.
- Ricevi una notifica: dopo la configurazione dell'account di fatturazione, vedrai una finestra di dialogo in AI Studio e riceverai un'email che ti informa del requisito.
- Esegui un pagamento : nella pagina delle chiavi API, fai clic su Azione necessaria in Livello di quota per la chiave appena collegata.
- Esegui l'upgrade: una volta elaborato correttamente il pagamento (operazione istantanea per la maggior parte dei metodi di pagamento), il tuo progetto verrà eseguito l'upgrade al livello a pagamento e verranno applicati i nuovi limiti di frequenza.
Fatturazione Cloud
L'API Gemini utilizza Cloud Billing per i servizi di fatturazione, che puoi configurare direttamente in AI Studio. Dopo aver abilitato la fatturazione Cloud, puoi utilizzare gli strumenti di fatturazione Cloud per monitorare le spese, comprendere i costi, effettuare pagamenti e accedere all'assistenza per la fatturazione Cloud.
I nuovi utenti vengono configurati immediatamente con un account di fatturazione Google Cloud a pagamento e ricevono 300 $di crediti di benvenuto.
Gli utenti esistenti che hanno già un account di fatturazione Cloud Google a pagamento o di prova senza costi possono selezionare un account di fatturazione Cloud Google esistente in AI Studio senza dover accedere alla console Google Cloud. Gli utenti esistenti non ricevono 300 $di crediti di benvenuto.
Scopri di più sulla configurazione automatica della fatturazione Cloud.
Monitorare l'utilizzo
Dopo aver attivato Cloud Billing, puoi monitorare l'utilizzo dell'API Gemini in Google AI Studio in Dashboard > Utilizzo e limiti.
Domande frequenti
Questa sezione fornisce 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 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 una quota maggiore, segui le istruzioni riportate in Eseguire l'upgrade al livello a pagamento successivo.
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 i miei crediti Google Cloud con l'API Gemini?
Sì, i crediti Google Cloud possono essere utilizzati per l'utilizzo dell'API Gemini.
Come viene gestita la fatturazione?
La fatturazione dell'API Gemini viene gestita dal sistema Cloud Billing. 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.
L'ottimizzazione dei modelli prevede un costo?
Il tuning del modello non è più supportato nell'API Gemini o in AIS.
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 su come vengono gestiti i dati quando è attivata 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 al mio pagamento anticipato?
L'intero importo viene aggiunto come credito al tuo account di fatturazione Cloud. Questo credito verrà utilizzato automaticamente per pagare l'utilizzo che accumuli su Google Cloud, inclusa l'API Gemini o altri servizi come Compute Engine e Cloud Storage. Non influisce sui crediti della prova senza costi.
Che cosa succede se non effettuo il pagamento anticipato?
Nessun problema. Il tuo progetto rimarrà nel livello senza costi dell'API Gemini. Non perderai l'accesso, ma sarai soggetto ai limiti di frequenza del livello senza costi. Puoi scegliere di completare il pagamento anticipato in qualsiasi momento futuro per eseguire l'upgrade.
Posso ricevere un rimborso per il mio pagamento anticipato?
Sì. Se nel tuo account è presente un saldo a credito, puoi richiedere un rimborso tramite la console Cloud, in conformità alle nostre norme sui rimborsi standard.
Il pagamento anticipato influisce sul mio credito della prova senza costi di 300 $?
No, è separato dai crediti della prova senza costi. Puoi continuare a utilizzare i crediti della prova senza costi per i prodotti idonei.
Che cosa succede se spendo più dell'importo prepagato?
Una volta esaurito il saldo del credito prepagato, il tuo account passerà alla fatturazione standard. Qualsiasi utilizzo aggiuntivo verrà addebitato sul metodo di pagamento principale collegato al tuo account di fatturazione Cloud.
Dove posso ricevere assistenza per la fatturazione?
Per ricevere assistenza in merito alla fatturazione, consulta la pagina Richiedi assistenza per la fatturazione Cloud.