Home › Chiavi API › Google Gemini
✓ Verificato sulle pagine ufficiali di Google il 23 settembre 2026. Schermate e prezzi cambiano: se qualcosa ti sembra diverso, fidati di quello che ti mostra Google.
Una chiave API Gemini è un codice segreto che permette a TranslateRocket di inviare i testi del tuo sito a Gemini, il modello AI di Google, e ricevere indietro la traduzione; Google offre un piano gratuito con dei limiti, e un piano a pagamento che ricarichi in anticipo.
📖 Parole che incontrerai
- Chiave API: un lungo codice segreto. Chiunque la possieda può usare la tua quota (e il tuo credito, se paghi), quindi trattala come una password.
- Google AI Studio: il sito di Google dove crei le chiavi Gemini, su aistudio.google.com.
- Progetto: un contenitore che Google usa per raggruppare le tue chiavi e la fatturazione. AI Studio ne crea uno per te.
- Livello gratuito / livello a pagamento: livello gratuito = nessuna carta, nessun addebito, ma limiti più bassi. Livello a pagamento = aggiungi una carta e prepaghi il credito.
- Token: l'unità con cui Google fa il conteggio. Per Gemini, 1 token corrisponde a circa 4 caratteri.
Cosa ti serve prima di iniziare
- Un account Google (va bene anche un indirizzo Gmail).
- Per il livello gratuito: nessuna carta. I nuovi account partono sul livello gratuito.
- Per il livello a pagamento: una carta di pagamento, e un prepagamento di almeno $5 (o l'equivalente nella tua valuta).
- Circa 5 minuti.
Prima di scegliere il piano gratuito: due avvisi sinceri
- Il tuo testo potrebbe essere usato da Google. Nel livello gratuito, Google può usare quello che invii per migliorare i suoi prodotti, e dei revisori umani potrebbero leggerlo. I termini di Google dicono di non inviare informazioni sensibili, riservate o personali. Le tue pagine web pubbliche di solito non sono segrete, ma pensaci se il tuo sito ha contenuti privati. Eccezione: se ti trovi nello Spazio economico europeo, in Svizzera o nel Regno Unito, Google dice che le regole sui dati del livello a pagamento si applicano a te anche sul livello gratuito.
- Attività in Europa o nel Regno Unito: leggi questo punto nei termini di Google. I termini di Google dicono che quando rendi disponibile un “API Client” a utenti nello Spazio economico europeo, in Svizzera o nel Regno Unito, puoi usare solo i servizi a pagamento. Se tradurre il tuo stesso sito rientri in questo caso è una questione legale a cui non possiamo rispondere per te. Se non sei sicuro, attiva la fatturazione (punto 7 qui sotto) o chiedi al tuo consulente.
Inoltre, il livello gratuito ha limiti di frequenza (quante richieste al minuto e al giorno). Google non pubblica numeri fissi nella sua pagina di documentazione; vedi i tuoi limiti direttamente in AI Studio. I siti grandi potrebbero richiedere più giorni, oppure il livello a pagamento.
Passo passo
Questo è tutto ciò che ti serve per il piano gratuito. Per passare al piano a pagamento (limiti più alti, e il tuo testo non viene usato per migliorare i prodotti di Google):
Utile da sapere: dal 28 maggio 2026 ogni nuova chiave creata in AI Studio è di un tipo nuovo e più sicuro (“auth key”). Google dice che rifiuterà le vecchie chiavi “standard” a partire da settembre 2026. Se hai una vecchia chiave Gemini, creane una nuova.
Quanto costa
Livello gratuito: gratuito sui modelli che Google offre gratis, entro i tuoi limiti di frequenza.
Livello a pagamento — prezzo ufficiale (pagina dei prezzi dell'API Gemini di Google, verificata il 23 Sep 2026), per 1 milione di token:
| Model | Testo che invii (input) | Testo che ricevi indietro (output, incluso il "thinking") |
|---|---|---|
| Gemini 2.5 Flash-Lite | $0.10 | $0.40 |
| Gemini 3.5 Flash-Lite | $0.30 | $2.50 |
| Gemini 2.5 Flash | $0.30 | $2.50 |
Il modello predefinito di TranslateRocket è gemini-flash-lite-latest, un nome che Google fa puntare alla sua ultima versione di Flash-Lite. Google non indica in quella pagina quale versione sia oggi, quindi controlla il prezzo del modello Flash-Lite che vedi in AI Studio.
Cosa significa per un piccolo sito. Il nostro esempio: un sito di 20 pagine con circa 600 parole ciascuna (12.000 parole, circa 75.000 caratteri), tradotto in una lingua.
- 75.000 caratteri corrispondono a circa 19.000 token.
- TranslateRocket invia anche brevi istruzioni con ogni gruppo di testi, e il testo tradotto è spesso più lungo dell'inglese. Per prudenza contiamo 30.000 token in entrata e 30.000 in uscita. I modelli Gemini più recenti possono anche “ragionare” prima di rispondere, e Google fattura quel ragionamento come output, quindi la cifra reale potrebbe essere più alta.
- Piano gratuito: $0.
- A pagamento, Gemini 2.5 Flash-Lite: 30,000 × $0.10 / 1,000,000 + 30,000 × $0.40 / 1,000,000 ≈ $0.02.
- A pagamento, Gemini 3.5 Flash-Lite: circa $0.08.
Il credito prepagato scade dopo 12 mesi e non è rimborsabile (tranne nei casi specifici indicati da Google).
Sicurezza (leggi con attenzione)
1. Con il piano gratuito non puoi essere addebitato. Senza la fatturazione configurata, Google non ha nessuna carta da addebitare.
2. Sul piano a pagamento, imposta un limite di spesa.
- In AI Studio, apri la pagina Spend.
- In Monthly spend cap, clicca su Edit spend cap.
- Inserisci un importo mensile, ad esempio $5, e salva.
Google indica questa funzione come sperimentale e avvisa che la spesa può superare il limite per circa 10 minuti prima di fermarsi. Se attivi la ricarica automatica, imposta anche un Monthly Limit: pagina Billing di AI Studio → Manage auto-reload → espandi Monthly Limit → inserisci un importo → Save. Con credito prepagato e ricarica automatica disattivata, non puoi mai perdere più del credito caricato.
3. Imposta un limite anche dentro TranslateRocket. In TranslateRocket → AI Translation, sezione Usage & limits, compila Daily character limit (per esempio 200000). Al raggiungimento del limite, la traduzione AI si ferma fino al giorno successivo. 0 significa nessun limite.
4. Non condividere mai la chiave. Google dice: trattala come una password. Non inserirla in e-mail, chat, screenshot o ticket di supporto.
5. Se pensi che la chiave sia trapelata (la checklist ufficiale di Google):
- Crea una nuova chiave in AI Studio e incollala in TranslateRocket.
- Disattiva o elimina la vecchia chiave nella pagina Credentials della console Google Cloud: https://console.cloud.google.com/apis/credentials (seleziona il progetto, poi la chiave). Una chiave eliminata può essere ripristinata entro 30 giorni se hai eliminato quella sbagliata.
- Controlla il tuo utilizzo in AI Studio (Dashboard → Usage) per individuare attività che non riconosci.
Dove incollarla in TranslateRocket
- Nella tua bacheca di WordPress, apri TranslateRocket → AI Translation.
- Nel riquadro Provider & keys, trova la scheda chiamata Google Gemini.
- Incolla la tua chiave nel campo API key.
- In cima al riquadro, imposta Active provider su Google Gemini.
- Facoltativo: il campo Model può restare vuoto (TranslateRocket userà allora gemini-flash-lite-latest). Il pulsante Load available models elenca i modelli che la tua chiave può usare.
- Clicca su Save AI settings in fondo alla pagina.
La scheda ora mostra il badge Active. Puoi tradurre dalla schermata Translations, oppure pagina per pagina nell'editor visuale.
Se qualcosa non funziona
| Cosa vedi | Cosa significa di solito | Cosa fare |
|---|---|---|
| Un errore relativo a una chiave non valida, oppure HTTP 400/403 | La chiave è stata copiata in modo errato, oppure è una vecchia chiave standard che Google non accetta più, oppure è contrassegnata come Blocked in AI Studio. | Incollala di nuovo con attenzione. Se continua a non funzionare, crea una nuova chiave in AI Studio: le nuove chiavi sono il tipo accettato. |
429 RESOURCE_EXHAUSTED |
Hai inviato troppo, troppo in fretta: i limiti del piano gratuito, oppure (piano a pagamento) il limite di velocità di spesa. I limiti giornalieri si azzerano a mezzanotte, ora del Pacifico. | Aspetta e riprova più tardi, traduci meno pagine alla volta, oppure passa al piano a pagamento. |
402 Pagamento richiesto |
Piano a pagamento: il tuo credito prepagato è a $0. Tutte le chiavi collegate a quell'account di fatturazione si fermano insieme. | Pagina Billing di AI Studio → Buy credits. |
Domande frequenti
La chiave API Gemini è gratuita?
Sì, c'è un piano gratuito senza carta, con limiti di frequenza che puoi vedere in Google AI Studio. Con il piano gratuito Google può usare il testo che invii per migliorare i suoi prodotti; regole diverse si applicano nello Spazio Economico Europeo, in Svizzera e nel Regno Unito.
La mia vecchia chiave API Gemini ha smesso di funzionare. Perché?
Dal 28 maggio 2026 le nuove chiavi create in AI Studio sono di un tipo nuovo e più sicuro, e Google dichiara che rifiuta le vecchie chiavi "standard" a partire da settembre 2026. Crea una nuova chiave in AI Studio.
Gemini è la stessa cosa di Google Cloud Translation?
No. Gemini è il modello AI di Google, con chiavi da Google AI Studio. Google Cloud Translation è il servizio professionale di Google Translate, con chiavi dalla console Google Cloud e fatturazione obbligatoria.
Quanto costa l'API Gemini a pagamento?
Il piano a pagamento parte con un prepagamento di $5. Con i modelli Flash-Lite, un sito di 20 pagine in una lingua costa circa da $0.02 a $0.08.
Quale dovrei scegliere?
Vedi la nostra pagina di confronto per un raffronto semplice tra tutti e cinque i servizi, e per l'opzione gratuita che non richiede alcuna chiave.
Altre guide: OpenAI · Anthropic (Claude) · DeepL · Google Cloud Translation · Quale dovrei scegliere?
