Come ottenere una chiave API Gemini — Google AI Studio e Kunavo passo dopo passo

Una chiave API Gemini è una credenziale bearer che autentica le chiamate ai modelli Gemini di Google. Esistono due modi per ottenere una chiave: direttamente da Google AI Studio (il metodo ufficiale) oppure tramite Kunavo — un'unica chiave compatibile con OpenAI per Gemini, Claude, GPT e i modelli di immagini/video, senza dover configurare un progetto Google Cloud. Questa guida illustra entrambi i metodi passo dopo passo e ti permette di chiamare Gemini in pochi minuti.

Opzione 1 — Google AI Studio (ufficiale)

Se utilizzi solo Gemini, puoi ottenere una chiave direttamente da Google:

1. Accedi all'indirizzo aistudio.google.com con un account Google.
2. Segui il percorso Get API key → Create API key. Le chiavi iniziano con AIza....
3. È disponibile un livello gratuito limitato, con limiti di frequenza, per la prototipazione.
4. Per i volumi di produzione devi collegare la chiave a un progetto Google Cloud con la fatturazione attivata.

Questa è la scelta giusta quando Gemini è l'unico modello che chiamerai. Se utilizzi anche modelli Claude, immagini o video, devi gestire una chiave, un SDK e una fattura separati per ogni fornitore.

Opzione 2 — Kunavo (consigliata per la produzione)

Kunavo offre Gemini tramite un'API compatibile con OpenAI. Un'unica chiave sk-kn- dà accesso a Gemini e a tutti gli altri modelli (tramite un endpoint compatibile con OpenAI), senza un progetto Google Cloud. Gemini ha un prezzo circa il 70% inferiore rispetto al listino Google, un unico saldo Stripe copre tutto e paghi in base al consumo a partire da $10.

1. Crea un account Kunavo e deposita $10 — paghi in base al consumo, il saldo non scade mai.
2. Crea una chiave nella pagina /app/keys. La chiave viene mostrata una sola volta; conservala in una variabile d'ambiente.
3. Indirizza l'SDK OpenAI verso https://api.kunavo.com/v1 ed effettua una chiamata utilizzando uno slug Gemini.
4. Effettua la chiamata — invia il campo del modello con un valore come gemini-2-5-flash, tutto qui.

Avvio rapido

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

import os
from openai import OpenAI

# Resmi OpenAI SDK'sını koruyun; yalnızca base_url ve model değişir.
client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # değişen tek satır
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Merhaba Gemini, kendini bir cümleyle tanıt."}],
)
print(resp.choices[0].message.content)

Mantieni la tua chiave al sicuro

• 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 le chiavi nei file .env e nelle variabili d'ambiente; non inserirle mai nel codice sorgente.
• Usa una chiave separata per ogni progetto o ambiente, così una fuga può essere revocata senza disabilitare tutto il resto.
• Esegui regolarmente la rotazione. Kunavo consente più chiavi attive contemporaneamente, quindi la rotazione crea una sovrapposizione di transizione ordinata invece di un'interruzione brusca.
• Imposta limiti di spesa per ogni chiave. Imposta un limite per ogni chiave tramite la dashboard e monitora il traffico imprevisto, suddiviso per chiave, nella pagina /app/usage.

Domande frequenti