Utilizzo delle chiavi API Gemini

Per utilizzare l'API Gemini, devi autenticare le richieste. Puoi eseguire l'autenticazione utilizzando una chiave API standard o di autorizzazione.

Creare o visualizzare una chiave API Gemini

Tipi di chiavi API: standard e di autorizzazione

Le chiavi API forniscono l'accesso all'API Gemini, ma le loro caratteristiche di sicurezza sono diverse. Per migliorare la sicurezza, l'API Gemini sta passando dalle chiavi API standard alle chiavi di autorizzazione:

• Chiavi API standard: associano le richieste a un progetto Google Cloud per la fatturazione e la quota. Le chiavi standard non identificano un chiamante, il che limita la granularità delle autorizzazioni e del controllo dell'accesso che possono supportare.
• Chiavi di autorizzazione: sono associate direttamente a un service account Google Cloud. Quando utilizzi una chiave di autorizzazione, le tue richieste vengono elaborate con l'identità del service account associato, consentendo un controllo dell'accesso granulare. Per impostazione predefinita, le chiavi di autorizzazione sono limitate all'API Generative Language (API Gemini) e forniscono un'applicazione rapida delle chiavi compromesse che interrompe rapidamente l'utilizzo delle chiavi compromesse rilevate dai nostri sistemi.

Per garantire un utilizzo sicuro, l'API Gemini passerà dalle chiavi standard alle chiavi di autorizzazione:

• Chiavi di autorizzazione predefinite: tutte le nuove chiavi API create in Google AI Studio vengono create automaticamente come chiavi di autorizzazione.
• Chiavi senza limitazioni rifiutate: l'API Gemini rifiuta le richieste provenienti da chiavi standard senza limitazioni. Le chiavi API standard a cui sono state applicate limitazioni esplicite continuano a funzionare. Questa limitazione impedisce l'utilizzo non autorizzato di chiavi che potrebbero essere condivise pubblicamente o collegate ad altri servizi.
• Settembre 2026: l'API Gemini rifiuterà le richieste provenienti da chiavi standard. Per evitare interruzioni del servizio, devi eseguire la migrazione alle chiavi di autorizzazione prima di questa data. Assicurati di eseguire la migrazione alle chiavi di autorizzazione prima di settembre 2026.

Gestire le chiavi API in Google AI Studio

Puoi gestire i progetti e le chiavi direttamente in Google AI Studio.

Progetti Google Cloud

Ogni chiave API Gemini è associata a un progetto Google Cloud. I progetti Google Cloud gestiscono la fatturazione, i collaboratori e le autorizzazioni. Google AI Studio fornisce un'interfaccia leggera per accedere a questi progetti.

• Progetto predefinito: se sei un nuovo utente, Google AI Studio crea automaticamente un progetto Google Cloud e una chiave API predefiniti dopo che hai accettato i Termini di servizio. Puoi rinominare questo progetto andando alla visualizzazione Progetti nella dashboard.
• Progetti esistenti: se hai già un account Google Cloud, AI Studio non crea un progetto predefinito. Devi invece importare i progetti esistenti.

Importare progetti

Per impostazione predefinita, Google AI Studio non mostra tutti i tuoi progetti Google Cloud. Devi importare i progetti che vuoi utilizzare:

1. Vai a Google AI Studio.
2. Apri la dashboard dal riquadro a sinistra e seleziona Progetti.
3. Fai clic sul pulsante Importa progetti.
4. Cerca e seleziona il progetto Google Cloud che vuoi importare, poi fai clic su Importa.
5. Una volta importato, vai alla pagina Chiavi API nella dashboard per creare una chiave nel progetto.

Risolvere i problemi relativi alle autorizzazioni di creazione delle chiavi

Se il pulsante Crea chiave API non è disponibile e viene visualizzato il messaggio: "Non hai l'autorizzazione per creare una chiave in questo progetto", non disponi delle autorizzazioni IAM richieste.

Chiedi all'amministratore del progetto cloud o dell'organizzazione Google Cloud di concederti un ruolo contenente le seguenti autorizzazioni (ad esempio Editor progetto):

• resourcemanager.projects.get: consente ad AI Studio di verificare il progetto.
• apikeys.keys.create: consente la generazione delle chiavi.
• serviceusage.services.enable: garantisce che l'API Generative Language sia abilitata.
• iam.serviceAccounts.create: necessaria per creare il service account collegato.
• iam.serviceAccountApiKeyBindings.create: associa il service account alla chiave API.

Se non riesci a ottenere l'accesso amministrativo, puoi creare un nuovo progetto Google Cloud non associato a un'organizzazione per generare le chiavi.

Configurazione dell'ambiente

Una volta ottenuta una chiave, configura l'ambiente per utilizzarla in modo sicuro nelle tue applicazioni.

Opzione 1: utilizzare le variabili di ambiente (consigliata)

Imposta la variabile di ambiente GEMINI_API_KEY o GOOGLE_API_KEY. Le librerie client dell'API Gemini rilevano e utilizzano automaticamente queste variabili. Se vengono impostate entrambe, GOOGLE_API_KEY ha la precedenza.

Seleziona il tuo sistema operativo per impostare la variabile:

~/.bashrc

touch ~/.bashrc && open ~/.bashrc