Come ottenere una chiave API Gemini — due metodi con Google AI Studio e Kunavo

Una chiave API Gemini è una credenziale bearer che autentica le chiamate ai modelli Gemini di Google. Esistono due modi per ottenerla: da Google AI Studio (ufficiale) oppure tramite un'unica chiave compatibile con OpenAI di Kunavo per chiamare Gemini, Claude, GPT e modelli di immagini/video in un unico posto (senza progetto Google Cloud). Questa guida illustra entrambe le procedure e spiega quale scegliere in produzione.

Metodo 1 — Google AI Studio (ufficiale)

Se utilizzi solo Gemini, ottenere la chiave direttamente da Google è la scelta standard.

1. Accedi a aistudio.google.com con il tuo account Google.
2. Apri Ottieni chiave API → Crea chiave API. La chiave ha un formato simile a AIza....
3. Per i prototipi è disponibile un livello gratuito con limiti di velocità. Per i carichi di produzione, devi associare la chiave a un progetto Google Cloud con la fatturazione attivata.

Se il modello che devi chiamare è solo Gemini, questa è la strada giusta. Se però utilizzi anche Claude o modelli di immagini e video, dovrai gestire chiavi, SDK e fatture separati per ogni provider.

Metodo 2 — Kunavo (consigliato per la produzione)

Kunavo colloca Gemini dietro un'API compatibile con OpenAI. Con un'unica chiave sk-kn- puoi raggiungere Gemini e tutti gli altri modelli, senza un progetto Google Cloud; i pagamenti confluiscono in un unico saldo Stripe. Gemini costa circa il 70% in meno rispetto ai prezzi ufficiali di Google e puoi iniziare con la fatturazione a consumo da $10.

1. Registrazione — Crea un account su kunavo.com.
2. Ricarica di $10 — La fatturazione è a consumo e il saldo non scade.
3. Crea una chiave — Crea una chiave in /app/keys. Inizia con sk-kn- e viene visualizzata una sola volta, quindi salvala in una variabile d'ambiente.
4. Effettua la chiamata — Indirizza base_url dell'SDK OpenAI verso https://api.kunavo.com/v1 e specifica lo slug Gemini.

Puoi verificare quale metodo sia più adatto anche nella tabella comparativa della documentazione sulle chiavi API Gemini. Per la suddivisione dei prezzi, consulta la guida ai prezzi dell'API Gemini.

Avvio rapido

Usa direttamente l'SDK ufficiale OpenAI. Devi modificare solo base_url e il nome del modello.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # 変更するのはこの 1 行だけ
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",  # Gemini モデルのスラッグを指定
    messages=[{"role": "user", "content": "Gemini を一文で説明して。"}],
)
print(resp.choices[0].message.content)

Gestione sicura delle chiavi

• Usa variabili d'ambiente. Non scrivere la chiave direttamente nel codice; leggila da una variabile d'ambiente come KUNAVO_API_KEY. I bundle browser e mobile sono pubblici: non esporre mai la chiave lato client e usa sempre un proxy tramite il tuo server.
• Ruota le chiavi regolarmente. Kunavo consente di avere più chiavi attive contemporaneamente, quindi la rotazione può avvenire con una sovrapposizione ordinata, senza un passaggio brusco. Come riferimento, eseguila ogni trimestre.
• Imposta un limite per ogni chiave. Configura un limite per ciascuna chiave nella dashboard e separa le chiavi per progetto o ambiente: in caso di fuga, puoi revocare solo quella chiave senza bloccare tutto. Monitora il traffico per chiave in /app/usage.

Domande frequenti