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 chiavi, SDK e fatture 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 1M di token di input e $0,75 per 1M 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. Ricarica 10 $: servizio a consumo, il saldo non scade mai.
3. Crea una chiave in /app/keys. La chiave inizia con sk-kn- e viene mostrata una sola volta; conservala in una variabile d'ambiente.
4. Effettua la chiamata indirizzando l'SDK OpenAI a https://api.kunavo.com/v1 e usando lo slug Gemini.

Guida rapida

Continua a usare l'SDK ufficiale OpenAI. Modifica 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",  # satu-satunya baris yang berubah
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Jelaskan RAG dalam dua kalimat."}],
)
print(resp.choices[0].message.content)

Sicurezza delle chiavi

• Non esporre mai una chiave sul lato client. I bundle per browser e dispositivi mobili sono pubblici: usa sempre un proxy attraverso il tuo server. Conserva la chiave in una variabile d'ambiente, al di fuori del codice versionato.
• Usa una chiave per progetto o ambiente, così una singola fuga può essere revocata senza compromettere le altre.
• Ruota le chiavi regolarmente. Kunavo consente di avere più chiavi attive contemporaneamente, rendendo la rotazione un passaggio graduale anziché un'interruzione improvvisa.
• Imposta un limite di spesa per chiave nella dashboard e monitora /app/usage per individuare traffico inatteso, suddiviso per chiave.

Domande frequenti