Come ottenere una chiave API Gemini — Google AI Studio vs Kunavo

Una chiave API Gemini è una credenziale bearer che autentica le chiamate ai modelli Gemini di Google. Esistono due modi per ottenerla: ricevere una chiave ufficiale da Google AI Studio oppure chiamare Gemini, Claude, GPT e modelli di immagini/video tramite un'unica chiave compatibile con OpenAI di Kunavo (senza progetto Google Cloud). Questa guida confronta i due percorsi e mostra il modo più rapido per iniziare subito a effettuare chiamate in produzione.

Metodo 1 — Google AI Studio (ufficiale)

Se prevedi di chiamare solo Gemini, è appropriato ottenere la chiave direttamente da Google.

1. Apri aistudio.google.com e accedi con il tuo account Google.
2. Crea la chiave tramite Get API key → Create API key. La chiave ha il formato AIza....
3. Il livello gratuito per la prototipazione ha limiti sulle richieste ed è adatto allo sviluppo iniziale.
4. Per gestire volumi di produzione, devi collegare la chiave a un account di fatturazione Google Cloud con la fatturazione attivata.

Se Gemini resterà l'unico modello che chiamerai, questo percorso è quello giusto. Se però utilizzi anche Claude o modelli di immagini/video, dovrai gestire chiavi, SDK e fatture separati per ogni provider.

Metodo 2 — Kunavo (consigliato per la produzione)

Kunavo colloca Gemini dietro un endpoint compatibile con OpenAI. Con un'unica chiave sk-kn- puoi chiamare tutti i modelli e pagare tramite un unico saldo Stripe, quindi non è necessario un progetto Google Cloud. Gemini costa circa 70% in meno rispetto ai prezzi ufficiali di Google; il saldo non scade e paghi a consumo a partire da una ricarica minima di $10.

1. Registrazione — Crea un account su kunavo.com.
2. Ricarica di $10 — Paghi 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 — Imposta base_url dell'SDK OpenAI su https://api.kunavo.com/v1 e chiama lo slug Gemini.

Avvio rapido

Usa direttamente l'SDK ufficiale OpenAI. Modifica solo base_url e il nome del modello: non c'è altro da cambiare.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # 바뀌는 건 이 줄뿐입니다
)

# 모델 슬러그만 바꾸면 Claude, GPT 등 다른 모델도 같은 키로 호출됩니다
resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "두 문장으로 자기소개를 해줘."}],
)
print(resp.choices[0].message.content)

Gestione sicura delle chiavi

• Usa variabili d'ambiente. Non inserire la chiave direttamente nel codice; conservala in 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 più chiavi attive, quindi puoi ruotarle con una sovrapposizione ordinata anziché con un passaggio brusco. È consigliabile farlo ogni trimestre.
• Imposta un limite di spesa per ogni chiave. Configura nella dashboard un limite per ciascuna chiave e controlla l'utilizzo per chiave in /app/usage: se una chiave viene compromessa, puoi revocarla senza influire sulle altre.

Domande frequenti