Guida · Chiave API Gemini
Google AI Studio: login e chiave API Gemini per Chaterimo
Accedi a Google AI Studio, crea una chiave API Gemini, attiva la fatturazione per il suo progetto e collegala a Chaterimo come chiave propria (BYOK).
In breve
- 01Una chiave API Gemini permette al tuo chatbot Chaterimo di rispondere con i modelli Gemini, e Google ti addebita direttamente ciò che il chatbot consuma (BYOK).
- 02La chiave si crea in Google AI Studio (aistudio.google.com) con il tuo account Google, non nell'app Gemini.
- 03Attiva la fatturazione per il progetto della chiave: senza, la chiave usa il livello gratuito di Google, i cui limiti si esauriscono dopo poche conversazioni del chatbot al giorno.
- 04Con Prepay, l'opzione predefinita per i nuovi utenti, tutte le chiavi dell'account di fatturazione si fermano quando il saldo del credito arriva a zero, e con loro il chatbot.
- 05Incolla la chiave in Chaterimo, in Impostazioni account, poi scegli un modello Gemini per il tuo chatbot.
Cosa ti serve
- Un piano Chaterimo che usa una chiave API propria (BYOK). La prova gratuita e i piani con le chiavi API di Chaterimo non richiedono alcuna chiave.
- Un account Google per accedere a Google AI Studio.
- Una carta di pagamento per l'account di fatturazione Google Cloud del progetto della chiave.
Indice 5
Per ottenere una chiave API Gemini, accedi a Google AI Studio (aistudio.google.com) con il tuo account Google e crea una chiave nella pagina API keys. Poi attiva la fatturazione per il progetto della chiave, perché il livello gratuito non basta per un chatbot. Incolla la chiave in Chaterimo, in Impostazioni account, e scegli un modello Gemini per il tuo chatbot. Questa guida è per i negozi online il cui piano Chaterimo usa una chiave API propria (BYOK: usi la tua chiave e paghi direttamente a Google ciò che il chatbot consuma).
Chaterimo è un chatbot IA e agente IA per negozi online su Shopify, Shoptet, Upgates, Eshop-rychle e altre piattaforme (tramite un feed prodotti). Risponde ai clienti in base al catalogo prodotti e alla base di conoscenza del negozio; con questa chiave usa i modelli Gemini sul tuo account Google.
Passaggi
1Accedi a Google AI Studio
Vai su aistudio.google.com e accedi con il tuo account Google. Non serve una registrazione separata. Alla prima visita accetta i termini; Google AI Studio crea poi per te un progetto Google Cloud predefinito e una chiave API.1
Google AI Studio non è l'app Gemini. L'app Gemini (gemini.google.com) è l'app di chat di Google; in AI Studio si trovano le chiavi API Gemini, i loro progetti e la fatturazione dell'API.
Con un account di lavoro Google Workspace, AI Studio è attivo per impostazione predefinita, ma l'amministratore può disattivarlo.2 Google AI Studio e l'API Gemini sono disponibili solo in alcuni paesi; Google li elenca nella sua pagina delle regioni disponibili.3
2Crea la chiave API Gemini
Apri la pagina API keys di AI Studio e seleziona Create API key. Scegli il progetto a cui appartiene la chiave. Il progetto predefinito del passaggio 1 va bene. La fatturazione e i limiti appartengono al progetto, quindi tutte le chiavi di un progetto li condividono.1
Copia la chiave e incollala in Chaterimo nel passaggio 4. Se AI Studio ha già creato una chiave per te nel passaggio 1, puoi usare quella.
Se usi già Google Cloud, AI Studio non crea un progetto predefinito. Apri Dashboard, seleziona Projects, poi Import projects, scegli il tuo progetto e seleziona Import. Poi crea la chiave nella pagina API keys.1
Attenzione
Tratta la chiave come una password. Non inviarla mai via e-mail o chat e non inserirla mai nel codice del tuo negozio. Chiunque abbia la chiave può usare l'API a tue spese. Se una chiave finisce in mani sbagliate, creane una nuova, incollala in Chaterimo e poi elimina quella vecchia in AI Studio.1
3Attiva la fatturazione per il progetto della chiave
Una chiave senza fatturazione usa il livello gratuito di Google. I suoi limiti consentono solo poche richieste al minuto e al giorno, e ogni risposta del chatbot richiede più richieste, quindi il limite si esaurisce dopo poche conversazioni. Con la fatturazione valgono limiti molto più alti, e Google non usa i tuoi prompt e le risposte per migliorare i suoi prodotti.4
- Nella pagina API keys o nella pagina Projects, trova il progetto della chiave e seleziona Set up billing nella colonna Billing Tier.
- Scegli un account di fatturazione Google Cloud, oppure aggiungine uno: seleziona il tuo paese, conferma i dati di contatto e aggiungi un metodo di pagamento.
- Acquista crediti prepagati quando AI Studio te lo chiede. Prepay è l'opzione predefinita per i nuovi utenti: paghi in anticipo e Google scala il consumo. Alcuni account ricevono invece Postpay, che fattura il consumo a posteriori. I crediti prepagati scadono 12 mesi dopo l'acquisto.4
Con Prepay, tutte le chiavi API di tutti i progetti dell'account di fatturazione si fermano insieme quando il saldo del credito arriva a zero, finché non acquisti altri crediti.4 Attiva la ricarica automatica nella pagina Billing di AI Studio con Setup auto-reload, così il chatbot non si ferma di notte o nel fine settimana.
Suggerimento
Per limitare la spesa mensile del progetto, apri la pagina Spend di AI Studio e seleziona Monthly spend cap, poi Edit spend cap. Google indica il limite come sperimentale: i dati di fatturazione arrivano con circa 10 minuti di ritardo, quindi la spesa può superarlo di poco.4
4Incolla la chiave in Chaterimo
In Chaterimo, apri Impostazioni account nel menu. Nella sezione Chiavi dei provider AI, incolla la chiave nel campo Chiave API Gemini e seleziona Salva. Il campo mostra poi Chiave salvata. Chaterimo conserva la chiave cifrata e la usa solo per le richieste a Google. Una sola chiave vale per tutti i chatbot della tua organizzazione.
Se non vedi la sezione Chiavi dei provider AI, il tuo piano non richiede una chiave propria: nella prova gratuita e nei piani con le chiavi API di Chaterimo, Chaterimo usa le proprie chiavi. Trovi i piani nella pagina dei prezzi.
5Scegli un modello Gemini per il tuo chatbot
Apri Impostazioni chat e integrazione. In Impostazioni generali del chatbot, scegli un modello Gemini in Tipo di modello AI e seleziona Salva modifiche. Un modello Gemini usa sempre la chiave Gemini del passaggio 4; un modello GPT o Claude richiederebbe una chiave del proprio fornitore.
Quando selezioni un modello Gemini, Chaterimo mostra una nota: l'API di Google a volte è sovraccarica, e il chatbot può allora rispondere «Modello AI temporaneamente sovraccarico». Se sul tuo negozio succede spesso, passa a un modello GPT o Claude, come consiglia la nota.
Il modello giusto per il tuo negozio dipende dalle domande dei tuoi clienti e dal tuo budget. Il nostro benchmark IA confronta i modelli su domande reali di assistenza clienti, e l'articolo come scegliere un LLM per l'assistenza clienti spiega i compromessi.
Come verificare che funzioni
- Apri Testa chatbot e fai una domanda che i tuoi clienti fanno spesso. Se il chatbot risponde, la chiave, la fatturazione e il modello funzionano.
- Nella pagina Projects di AI Studio, la colonna Billing Tier del progetto della chiave mostra un livello a pagamento invece del livello gratuito.
- Se Chaterimo ha mostrato un avviso rosso sulla tua chiave Gemini, l'avviso scompare dopo la prossima risposta andata a buon fine.
Risoluzione dei problemi
- «Non hai ancora salvato una chiave API di un provider di IA»
- Il tuo piano usa una chiave propria, ma in Chaterimo non c'è la chiave di nessun fornitore. Incolla la chiave Gemini in Impostazioni account (passaggio 4).
- «La chiave API di Google Gemini utilizza il livello gratuito di Google (free tier) e ha esaurito il limite di richieste»
- Il progetto della chiave non ha la fatturazione attiva, quindi il chatbot ha esaurito i limiti gratuiti. Attiva la fatturazione per il progetto (passaggio 3). Chaterimo invia questo avviso anche via e-mail al proprietario dell'account, al massimo una volta al giorno.
- «Il tuo provider di IA (Google) segnala che i crediti del tuo account sono esauriti o che è stato raggiunto un limite di spesa»
- Il saldo prepagato dell'account di fatturazione è arrivato a zero (AI Studio mostra No credits per il progetto), oppure l'account di fatturazione non è attivo. Chaterimo usa lo stesso testo di avviso per ogni fornitore, per questo cita anche un limite di spesa. Seleziona Buy credits nella pagina Billing e attiva la ricarica automatica (passaggio 3).4
- «La tua chiave API per Google non è valida o è stata revocata»
- La chiave è stata eliminata, bloccata o copiata in modo incompleto. Crea una nuova chiave (passaggio 2) e incollala in Chaterimo. Chaterimo invia questo avviso anche via e-mail, al massimo una volta al giorno.
- Una chiave più vecchia mostra Unrestricted o Blocked in AI Studio
- L'API Gemini rifiuta le chiavi senza restrizioni del tipo più vecchio e blocca le chiavi senza restrizioni rimaste inutilizzate a lungo. Crea una nuova chiave (passaggio 2): le chiavi create in AI Studio ora funzionano solo con l'API Gemini. Puoi anche selezionare Add restrictions accanto alla chiave senza restrizioni, scegliere Restrict to Gemini API only e selezionare Restrict key.1
- Il chatbot risponde «Il modello di IA è temporaneamente sovraccarico. Riprova tra un momento.»
- L'API di Google era sovraccarica. Chaterimo ripete la richiesta prima di mostrare questa risposta. Se succede spesso, scegli un altro modello Gemini oppure un modello GPT o Claude (passaggio 5).
- AI Studio dice che non hai accesso a Google AI Studio
- L'amministratore di Google Workspace ha disattivato AI Studio per il tuo account. Chiedi all'amministratore di attivarlo, oppure accedi con un altro account Google.2
- «You do not have permission to create a key in this project»
- Il tuo ruolo nel progetto Google Cloud non consente di creare chiavi. Chiedi al proprietario del progetto un ruolo come Editor, oppure crea la chiave in un progetto tuo.1
Passo successivo
Confronta Gemini con altri modelli nel benchmark IA e scegli quello più adatto alle domande dei tuoi clienti. Per provare anche i modelli GPT o Claude, segui le guide alla chiave API OpenAI e alla chiave API Anthropic. Poi prova il chatbot con le tue domande in Testa chatbot prima di mostrarlo sul tuo negozio online.
-
Google, «Using Gemini API keys», consultato il 19 ottobre 2026, https://ai.google.dev/gemini-api/docs/api-key ↑↑↑↑↑↑
-
Google, «Access Google AI Studio with your Workspace account», consultato il 19 ottobre 2026, https://ai.google.dev/gemini-api/docs/workspace ↑↑
-
Google, «Available regions for Google AI Studio and Gemini API», consultato il 19 ottobre 2026, https://ai.google.dev/gemini-api/docs/available-regions ↑
-
Google, «Billing», consultato il 19 ottobre 2026, https://ai.google.dev/gemini-api/docs/billing ↑↑↑↑↑
Domande frequenti
L'API Gemini è gratuita?
Google offre un livello gratuito, ma i suoi limiti si esauriscono dopo poche conversazioni del chatbot al giorno. Per un chatbot sul tuo negozio, attiva la fatturazione per il progetto della chiave. Con un livello a pagamento, Google non usa i tuoi prompt e le risposte per migliorare i suoi prodotti.
Serve un account separato per Google AI Studio?
No. Accedi ad AI Studio con il tuo account Google. Per la fatturazione aggiungi un account di fatturazione Google Cloud quando la attivi per il progetto della chiave.
Google AI Studio è la stessa cosa dell'app Gemini?
No. L'app Gemini (gemini.google.com) è l'app di chat di Google. Le chiavi API Gemini e la fatturazione dell'API si trovano in Google AI Studio (aistudio.google.com).
Posso usare una sola chiave Gemini per più chatbot in Chaterimo?
Sì. La chiave si salva in Impostazioni account e vale per tutti i chatbot della tua organizzazione. Ogni chatbot può usare un modello Gemini diverso.
Quanto costa l'API Gemini per un chatbot?
Dipende dal modello e dal numero di conversazioni. Google pubblica i suoi prezzi nella pagina dei prezzi dell'API Gemini. Il piano Chaterimo viene fatturato a parte; vedi la pagina dei prezzi di Chaterimo.
Modifiche
- Il titolo cita il login; aggiunta una breve descrizione di cos'è Chaterimo e a cosa serve la chiave.
- Riscritta per l'attuale fatturazione di Google AI Studio e le impostazioni di Chaterimo, con la risoluzione dei problemi.
- Pubblicata.