Chiave API Gemini — come ottenerla e usarla con l’SDK OpenAI

Una chiave API Gemini è una credenziale che autentica le tue chiamate ai modelli Gemini di Google: ogni richiesta include la chiave nell'header Authorization e l'utilizzo viene misurato e addebitato per token. Esistono due modi per ottenere una chiave funzionante: Google AI Studio (ufficiale), che fornisce una chiave dedicata a Gemini, oppure Kunavo, dove un'unica chiave compatibile con OpenAI consente di accedere a Gemini, Claude, GPT e ai modelli di immagini, video e audio, senza un progetto Google Cloud. Questa guida spiega come ottenere una chiave con entrambi i metodi e come effettuare la prima chiamata.

Opzione 1 — Google AI Studio (ufficiale)

Questo è il percorso giusto se Gemini è l'unico modello che chiamerai.

1. Accedi a aistudio.google.com con un account Google.
2. Apri Get API key → Create API key. La chiave ha il formato AIza....
3. Il livello gratuito è limitato ed è adatto ai prototipi. Per i volumi di produzione, la chiave deve essere collegata a un progetto Google Cloud con un account di fatturazione attivo.

Se usi anche Claude, immagini o video, questo percorso ti obbliga a gestire una chiave, un SDK e una fattura separati per ogni provider.

Opzione 2 — Kunavo (consigliata per la produzione)

Kunavo mette Gemini dietro un'API compatibile con OpenAI. Un'unica chiave sk-kn- chiama Gemini e tutti gli altri modelli, con un unico portafoglio fatturato tramite Stripe e senza alcun progetto Google Cloud. Gemini costa circa il 70% in meno rispetto al listino ufficiale di Google: Flash, per esempio, costa $0,09 per ogni milione di token di input e $0,75 per ogni milione di token di output. È un servizio a consumo a partire dalla ricarica minima di 10 $ e il saldo non scade mai.

1. Registrati su kunavo.com.
2. Deposita $10 — paghi man mano che utilizzi il servizio, il saldo non scade mai.
3. Crea una chiave su /app/keys. La chiave inizia con sk-kn- e viene mostrata una sola volta; salvala in una variabile d'ambiente.
4. Effettua chiamate indirizzando l'SDK OpenAI verso https://api.kunavo.com/v1 e utilizzando uno slug Gemini.

Guida rapida

Mantieni l'SDK ufficiale OpenAI. Cambia base_url e il nome del modello — nient'altro:

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # dòng duy nhất thay đổi
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Giải thích RAG trong hai câu."}],
)
print(resp.choices[0].message.content)

Sicurezza della chiave

• Non esporre mai la chiave lato client. I bundle per browser e dispositivi mobili sono pubblici — effettua sempre il proxy tramite il tuo server. Conserva la chiave in una variabile d'ambiente, al di fuori del codice sottoposto a controllo versione.
• Usa una chiave per ogni progetto o ambiente, così, in caso di fuga, puoi revocarla senza mettere fuori uso il resto.
• Ruota periodicamente le chiavi. Kunavo consente di avere più chiavi attive contemporaneamente, quindi la rotazione è una transizione ordinata, non un'interruzione improvvisa.
• Imposta limiti di spesa per ogni chiave nella dashboard e monitora /app/usage per rilevare traffico anomalo, suddiviso per chiave.

Domande frequenti