Chiave API Gemini

Una chiave API Gemini autentica le chiamate ai modelli Gemini di Google. Puoi ottenerla direttamente da Google AI Studio oppure usare un'unica chiave sk-kn- per accedere a Gemini tramite la stessa API compatibile con OpenAI che già usi per tutto il resto.

Cos'è una chiave API Gemini

Una chiave API Gemini è una credenziale bearer che autorizza le richieste alla famiglia di modelli Gemini di Google. Ogni richiesta include la chiave in un'intestazione Authorization; la piattaforma misura l'utilizzo in base a essa e applica la fatturazione per token. Attualmente, su Kunavo, questo include gemini-3-1-pro e gemini-2-5-flash, richiamati tramite l'endpoint compatibile con OpenAI.

Puoi ottenere una chiave funzionante in due modi, a seconda che tu voglia usare solo Gemini o affiancarlo ad altri modelli all'avanguardia.

Opzione A — una chiave direttamente da Google AI Studio

1. Vai su aistudio.google.com e accedi con un account Google.
2. Apri Get API key → Create API key. Le chiavi hanno il formato AIza....
3. Per i volumi di produzione, associa la chiave a un progetto Google Cloud con la fatturazione abilitata.

Questo è il percorso giusto se userai solo Gemini. Se usi anche Claude, modelli di immagini o video, dovrai gestire una chiave, un SDK e una fattura separati per ogni provider.

Opzione B — un'unica chiave Kunavo per Gemini e tutto il resto

Kunavo è un gateway API AI indipendente e compatibile con OpenAI: con un’unica chiave API e un saldo a consumo puoi accedere ai modelli Claude, GPT e di immagini, video e audio, senza bisogno di un account per ciascun fornitore.

Kunavo offre Gemini tramite un'API compatibile con OpenAI. Un'unica chiave sk-kn- consente di accedere a Gemini e a tutti gli altri modelli, con un solo saldo fatturato tramite Stripe.

1. Crea un account Kunavo e aggiungi una ricarica di $10: paghi a consumo e il saldo non scade.
2. Genera una chiave su /app/keys. Viene mostrata una sola volta: conservala in una variabile d'ambiente.
3. Configura l'SDK OpenAI con https://api.kunavo.com/v1 e chiama uno slug Gemini.

Chiama Gemini con Python

Continua a usare l'SDK ufficiale OpenAI. Modifica base_url e il nome del modello: non serve altro.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # the only line that changes
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Summarize the plot of Dune in two sentences."}],
)
print(resp.choices[0].message.content)

Chiama Gemini con Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.KUNAVO_API_KEY,
  baseURL: "https://api.kunavo.com/v1",
});

const resp = await client.chat.completions.create({
  model: "gemini-2-5-flash",
  messages: [{ role: "user", content: "Summarize the plot of Dune in two sentences." }],
});
console.log(resp.choices[0].message.content);

Oppure chiamalo con curl

curl https://api.kunavo.com/v1/chat/completions \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2-5-flash",
    "messages": [{"role": "user", "content": "Hello, Gemini"}]
  }'

Quale modello Gemini usare

• gemini-2-5-flash — modello predefinito veloce ed estremamente economico per chat, estrazione e sintesi.
• gemini-3-1-pro — ragionamento più avanzato, visione e analisi di contesti lunghi.

Elenco di controllo della sicurezza

• Non esporre mai una chiave lato client. I bundle per browser e dispositivi mobili sono pubblici: passa sempre da un proxy sul tuo server.
• Usa una chiave per progetto o ambiente, così in caso di fuga puoi revocarla senza bloccare tutto il resto.
• Ruota le chiavi ogni trimestre. Kunavo consente più chiavi attive, quindi la rotazione permette una sovrapposizione senza interruzioni.
• Monitora /app/usage per individuare traffico imprevisto, suddiviso per chiave.

FAQ

Prossimi passi

• Guida rapida — la tua prima richiesta in 60 secondi
• Prezzi dell'API Gemini 2026
• Esplora il catalogo completo dei modelli