I limiti di frequenza regolano il numero di richieste che puoi effettuare all'API Gemini in un determinato periodo di tempo. Questi limiti contribuiscono a mantenere un utilizzo equo, proteggere dagli abusi e mantenere le prestazioni del sistema per tutti gli utenti.
Visualizzare i limiti di frequenza attivi in AI Studio
Come funzionano i limiti di frequenza
I limiti di frequenza vengono in genere misurati in tre dimensioni:
- Richieste al minuto (RPM)
- Token al minuto (input) (TPM)
- Richieste al giorno (RPD)
Il tuo utilizzo viene valutato in base a ciascun limite e il superamento di uno qualsiasi di questi limiti attiva un errore di limite di frequenza. Ad esempio, se il limite RPM è 20, l'invio di 21 richieste in un minuto genererà un errore, anche se non hai superato il limite TPM o altri limiti.
I limiti di frequenza vengono applicati per progetto, non per chiave API. Le quote per le richieste al giorno (RPD) vengono reimpostate alla mezzanotte del fuso orario del Pacifico.
I limiti variano a seconda del modello specifico utilizzato e alcuni limiti si applicano solo a modelli specifici. Ad esempio, le immagini al minuto (IPM) vengono calcolate solo per i modelli in grado di generare immagini (Nano Banana), ma sono concettualmente simili ai token al minuto (TPM). Altri modelli potrebbero avere un limite di token al giorno (TPD).
I limiti di frequenza sono più restrittivi per i modelli sperimentali e di anteprima.
Livelli di utilizzo
I limiti di frequenza sono legati al livello di utilizzo del progetto. Man mano che l'utilizzo e la spesa per le API aumentano, verrà eseguito automaticamente l'upgrade a un livello superiore con limiti di frequenza più elevati.
I requisiti per i livelli 2 e 3 si basano sulla spesa cumulativa totale per i servizi Google Cloud (inclusa, a titolo esemplificativo, l'API Gemini) per l' account di fatturazione collegato al tuo progetto.
| Livello | Requisiti |
|---|---|
| Nessun costo | Utenti nei paesi idonei |
| Livello 1 | Account di fatturazione a pagamento completo collegato al progetto |
| Livello 2 | Spesa totale: > 250 $ e almeno 30 giorni dal pagamento andato a buon fine |
| Livello 3 | Spesa totale: > 1000 $ e almeno 30 giorni dal pagamento andato a buon fine |
Quando richiedi un upgrade, il nostro sistema automatico di protezione dagli abusi esegue controlli aggiuntivi. Sebbene il rispetto dei criteri di qualifica indicati sia generalmente sufficiente per l'approvazione, in rari casi una richiesta di upgrade può essere rifiutata in base ad altri fattori identificati durante la procedura di revisione.
Questo sistema contribuisce a mantenere la sicurezza e l'integrità della piattaforma Gemini API per tutti gli utenti.
Limiti di frequenza dell'API Gemini
I limiti di frequenza dipendono da una serie di fattori (ad esempio il livello di quota) e possono essere visualizzati in Google AI Studio. Man mano che il tuo livello e lo stato dell'account cambiano nel tempo, i limiti di frequenza verranno aggiornati automaticamente.
Visualizzare i limiti di frequenza attivi in AI Studio
I limiti di frequenza specificati non sono garantiti e la capacità effettiva potrebbe variare.
Limiti di frequenza delle richieste API Batch
Le richieste API batch sono soggette a limiti di frequenza propri, separati dalle chiamate API non batch.
- Richieste batch simultanee:100
- Limite dimensioni file di input: 2 GB
- Limite di spazio di archiviazione dei file: 20 GB
- Token in coda per modello:la tabella Token batch in coda elenca il numero massimo di token che possono essere messi in coda per l'elaborazione batch in tutti i job batch attivi per un determinato modello.
Livello 1
| Modello | Token in coda in batch | |||
|---|---|---|---|---|
| Modelli di testo | ||||
| Gemini 3.1 Pro (anteprima) | 5.000.000 | |||
| Anteprima di Gemini 3 Pro | 5.000.000 | |||
| Anteprima di Gemini 3 Flash | 3.000.000 | |||
| Gemini 2.5 Pro | 5.000.000 | |||
| Gemini 2.5 Pro TTS | 25.000 | |||
| Gemini 2.5 Flash | 3.000.000 | |||
| Anteprima di Gemini 2.5 Flash | 3.000.000 | |||
| Anteprima di Gemini 2.5 Flash Image | 3.000.000 | |||
| Gemini 2.5 Flash TTS | 100.000 | |||
| Gemini 2.5 Flash-Lite | 10.000.000 | |||
| Anteprima di Gemini 2.5 Flash-Lite | 10.000.000 | |||
| Gemini 2.0 Flash | 10.000.000 | |||
| Gemini 2.0 Flash Image | 3.000.000 | |||
| Gemini 2.0 Flash-Lite | 10.000.000 | |||
| Modelli di generazione multimodali | ||||
| Anteprima di Gemini 3 Pro Image 🍌 | 2.000.000 | |||
Livello 2
| Modello | Token in coda in batch | |||
|---|---|---|---|---|
| Modelli di testo | ||||
| Gemini 3.1 Pro (anteprima) | 500.000.000 | |||
| Anteprima di Gemini 3 Pro | 500.000.000 | |||
| Anteprima di Gemini 3 Flash | 400.000.000 | |||
| Gemini 2.5 Pro | 500.000.000 | |||
| Gemini 2.5 Pro TTS | 100.000 | |||
| Gemini 2.5 Flash | 400.000.000 | |||
| Anteprima di Gemini 2.5 Flash | 400.000.000 | |||
| Anteprima di Gemini 2.5 Flash Image | 400.000.000 | |||
| Gemini 2.5 Flash TTS | 100.000 | |||
| Gemini 2.5 Flash-Lite | 500.000.000 | |||
| Anteprima di Gemini 2.5 Flash-Lite | 500.000.000 | |||
| Gemini 2.0 Flash | 1.000.000.000 | |||
| Gemini 2.0 Flash Image | 400.000.000 | |||
| Gemini 2.0 Flash-Lite | 1.000.000.000 | |||
| Modelli di generazione multimodali | ||||
| Anteprima di Gemini 3 Pro Image 🍌 | 270.000.000 | |||
Livello 3
| Modello | Token in coda in batch | |||
|---|---|---|---|---|
| Modelli di testo | ||||
| Gemini 3.1 Pro (anteprima) | 1.000.000.000 | |||
| Anteprima di Gemini 3 Pro | 1.000.000.000 | |||
| Anteprima di Gemini 3 Flash | 1.000.000.000 | |||
| Gemini 2.5 Pro | 1.000.000.000 | |||
| Gemini 2.5 Pro TTS | 1.000.000 | |||
| Gemini 2.5 Flash | 1.000.000.000 | |||
| Anteprima di Gemini 2.5 Flash | 1.000.000.000 | |||
| Anteprima di Gemini 2.5 Flash Image | 1.000.000.000 | |||
| Gemini 2.5 Flash TTS | 4.000.000 | |||
| Gemini 2.5 Flash-Lite | 1.000.000.000 | |||
| Anteprima di Gemini 2.5 Flash-Lite | 1.000.000.000 | |||
| Gemini 2.0 Flash | 5.000.000.000 | |||
| Gemini 2.0 Flash Image | 1.000.000.000 | |||
| Gemini 2.0 Flash-Lite | 5.000.000.000 | |||
| Modelli di generazione multimodali | ||||
| Anteprima di Gemini 3 Pro Image 🍌 | 1.000.000.000 | |||
Come eseguire l'upgrade al livello successivo
Per eseguire la transizione dal livello senza costi a un livello a pagamento, devi prima configurare la fatturazione in AI Studio.
Una volta che il progetto soddisfa i criteri specificati, verrà eseguito automaticamente l'upgrade al livello successivo. Gli upgrade dal Livello senza costi al Livello 1 in genere hanno effetto immediatamente, mentre gli upgrade successivi hanno effetto entro 10 minuti. Vai alla pagina Progetti in AI Studio per controllare i tuoi livelli.
Richiedere un aumento del limite di frequenza
Ogni variante del modello ha un limite di frequenza associato (richieste al minuto, RPM). Per informazioni dettagliate su questi limiti di frequenza, consulta la pagina Limite di frequenza di AI Studio.
Richiedere un aumento del limite di frequenza per il livello a pagamento
Non offriamo garanzie in merito all'aumento del limite di frequenza, ma faremo del nostro meglio per esaminare la tua richiesta.