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). 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 prompt e le risposte non vengano utilizzati per migliorare i prodotti Google (privacy dei dati di livello enterprise). 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 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 di 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 del tuo account di fatturazione. Fai clic su Cambia 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.
- La finestra successiva ti informerà sullo stato della 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 Fatturazione Cloud.
- Fai clic su Termina configurazione.
- La finestra successiva ti informerà sullo stato della 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 comunicherà 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 per l'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à aggiornato al livello a pagamento e verranno applicati i nuovi limiti di frequenza.
Monitorare l'utilizzo
Puoi monitorare l'utilizzo dell'API Gemini in Google AI Studio in Dashboard > Utilizzo.
Fatturazione Cloud
L'API Gemini utilizza Cloud Billing per i servizi di fatturazione, che puoi configurare direttamente in AI Studio. Puoi utilizzare AI Studio per monitorare le spese e comprendere i costi. Puoi accedere alle stesse informazioni ed effettuare pagamenti nel tuo account di fatturazione Cloud.
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 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ì, offriamo 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 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 Cloud Billing. Scopri di più sulla configurazione automatica della fatturazione nella documentazione di Cloud Billing.
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 è 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 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.
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 base alle nostre norme sui rimborsi standard.
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.