Creare una chiave API Google Gemini — due percorsi (Google AI Studio e Kunavo)

Una chiave API Gemini autentica le tue chiamate ai modelli Gemini di Google: ogni richiesta trasporta la chiave nell'header Authorization, e la piattaforma misura e fattura l'utilizzo tramite essa. Esistono due modi per creare una chiave API Gemini — direttamente tramite Google AI Studio (ufficiale) oppure tramite Kunavo: una chiave compatibile con OpenAI che consente di accedere a Gemini, Claude, GPT e modelli di immagini e video, senza alcun progetto Google Cloud.

Opzione 1 — Crea una chiave API di Google AI Studio (ufficiale)

Se Gemini è l'unico modello che chiamerai, ottieni la chiave direttamente da Google:

1. Apri aistudio.google.com e accedi con un account Google.
2. Apri Get API key → Create API key. Le chiavi iniziano con AIza… e vengono mostrate una sola volta.
3. Il livello gratuito è soggetto a limiti di frequenza ed è adatto alla prototipazione. Per la produzione collega la chiave a un account di fatturazione Google Cloud.

Questo è il percorso corretto finché ti serve solo Gemini. Quando utilizzi anche Claude, GPT o modelli di immagini e video, gestisci una chiave, un SDK e una fattura separati per ogni provider.

Opzione 2 — Crea una chiave API Gemini tramite Kunavo (consigliato per la produzione)

Kunavo fornisce Gemini tramite un'API compatibile con OpenAI. Un'unica chiave sk-kn- consente di accedere a tutti i modelli tramite lo stesso endpoint — non è necessario alcun progetto Google Cloud, Gemini costa circa il 70% in meno rispetto al listino Google ($0,09 / $0,75 per 1M di token), un saldo Stripe, pay-as-you-go a partire da una ricarica minima di $10. Il saldo copre congiuntamente Gemini, Claude, GPT e modelli di immagini e video e non scade mai.

1. Registrati. Crea un account Kunavo su kunavo.com.
2. Ricarica $10. Pay-as-you-go a partire da una ricarica minima di $10; il credito non scade mai.
3. Crea la chiave. Genera una chiave in /app/keys. Inizia con sk-kn- e viene mostrata una sola volta — salvala in una variabile d'ambiente.
4. Effettua la chiamata. Configura l'SDK OpenAI su https://api.kunavo.com/v1 e richiama uno slug Gemini.

Guida rapida

Mantieni l'SDK OpenAI ufficiale. Devi modificare solo 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",  # die einzige Zeile, die sich ändert
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Fasse die Handlung von Dune in zwei Sätzen zusammen."}],
)
print(resp.choices[0].message.content)

Lo stesso schema vale per Node.js e curl; le tariffe per modello e gli esempi con calcoli completi sono disponibili nella guida ai prezzi dell'API Gemini.

Conserva la chiave in modo sicuro

• Variabili d'ambiente invece del codice sorgente. Non inserire mai la chiave nel repository; leggila da una variabile d'ambiente. Non esporla mai in bundle per browser o dispositivi mobili — usa sempre un proxy tramite il tuo server.
• Una chiave per progetto o ambiente. In questo modo puoi revocare una chiave esposta senza bloccare tutto il resto.
• Ruota regolarmente le chiavi. Kunavo consente più chiavi attive, quindi la rotazione permette una sovrapposizione ordinata invece di un'interruzione netta.
• Limiti di output per chiave. Imposta limiti per chiave nella dashboard e monitora il traffico imprevisto per ogni chiave in /app/usage.

Domande frequenti