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

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

Opzione 1 — 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. Vai a Get API key → Create API key. Le chiavi iniziano con AIza… e vengono visualizzate una sola volta.
3. Il livello gratuito ha limiti di velocità ed è adatto alla prototipazione. Per la produzione, collega la chiave a un account di fatturazione Google Cloud.

È la scelta giusta finché ti serve solo Gemini. Quando inizi a usare anche Claude, GPT o modelli di immagini e video, gestisci una chiave, un SDK e una fattura per ogni provider.

Opzione 2 — Kunavo (consigliata per la produzione)

Kunavo mette Gemini dietro un'API compatibile con OpenAI. Un'unica chiave sk-kn- consente di accedere a tutti i modelli tramite lo stesso endpoint — nessun progetto Google Cloud, Gemini a circa 70 % in meno rispetto al prezzo di listino di Google ($0,09 / $0,75 per 1M di token), un saldo Stripe e pay-as-you-go a partire da una ricarica di $10. Il saldo copre insieme Gemini, Claude, GPT, 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 saldo non scade mai.
3. Crea la chiave. Genera una chiave in /app/keys. Inizia con sk-kn- e viene visualizzata una sola volta: conservala in una variabile d'ambiente.
4. Effettua la chiamata. Indirizza l'SDK OpenAI a https://api.kunavo.com/v1 e chiama uno slug Gemini.

Guida rapida

Mantieni l'SDK ufficiale di OpenAI. 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",  # la seule ligne qui change
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Résume l'intrigue de Dune en deux phrases."}],
)
print(resp.choices[0].message.content)

Lo stesso pattern vale per Node.js e curl; le tariffe per modello e gli esempi dettagliati sono nella guida ai prezzi dell'API Gemini.

Mantenere sicura la chiave

• Variabili d'ambiente, non codice sorgente. Non eseguire mai il commit della chiave nel repository; leggila da una variabile d'ambiente. Non esporla mai in un bundle del browser o dell'app mobile: passa sempre dal tuo server.
• Una chiave per progetto o ambiente. In questo modo una chiave compromessa può essere revocata senza interrompere nient'altro.
• Rotazione regolare. Kunavo consente più chiavi attive, quindi la rotazione avviene con una sovrapposizione controllata invece che con un'interruzione improvvisa.
• Limiti di spesa per chiave. Imposta i limiti per chiave nella dashboard e monitora il traffico inatteso per chiave in /app/usage.

Domande frequenti