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

Una chiave API Gemini è la credenziale che autentica le tue chiamate ai modelli Gemini di Google: ogni richiesta include la chiave in un'intestazione 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 solo per Gemini, oppure Kunavo, dove un'unica chiave compatibile con OpenAI dà accesso a Gemini, Claude, GPT e ai modelli di immagini, video e audio, senza bisogno di un progetto Google Cloud. Questa guida spiega come ottenere la chiave in entrambi i modi e come effettuare la prima chiamata.

Opzione 1 — Google AI Studio (ufficiale)

È la scelta giusta 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. Le chiavi hanno il formato AIza....
3. Il livello gratuito è limitato ed è adatto ai prototipi. Per i volumi di produzione, devi collegare la chiave a un progetto Google Cloud con un account di fatturazione attivato.

Se utilizzi anche Claude, modelli di immagini o video, con questo approccio devi gestire una chiave, un SDK e una fattura separati per ogni fornitore.

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 addebitato tramite Stripe e senza alcun progetto Google Cloud. Gemini costa circa il 70% in meno rispetto al prezzo di listino Google — Flash, per esempio, costa $0,09 per 1M di token in ingresso e $0,75 per 1M di token in uscita. Paghi in base al consumo a partire da un deposito minimo di $10 e il saldo non scade mai.

1. Registrati su kunavo.com.
2. Deposita $10 — paghi in base al consumo, il saldo non scade mai.
3. Crea una chiave su /app/keys. Inizia con sk-kn- e viene mostrata una sola volta; conservala in una variabile d'ambiente.
4. Effettua la chiamata 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",  # a única linha que muda
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Explique RAG em duas frases."}],
)
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 nelle variabili d'ambiente, al di fuori del codice sottoposto a controllo versione.
• Usa una chiave per ogni progetto o ambiente, così una fuga può essere revocata senza mettere fuori uso il resto.
• Esegui la rotazione periodicamente. Kunavo consente più chiavi attive contemporaneamente, quindi la rotazione è una sovrapposizione ordinata, non un'interruzione improvvisa.
• Imposta limiti di spesa per ogni chiave nella dashboard e monitora /app/usage per individuare traffico imprevisto, suddiviso per chiave.

Domande frequenti