Ottieni una chiave API Gemini

Per utilizzare l'API Gemini, devi disporre di una chiave API. Puoi creare una chiave con pochi clic in Google AI Studio.

Ottenere una chiave API Gemini in Google AI Studio

Configurare la chiave API

Per i test iniziali, puoi codificare una chiave API, ma deve essere solo provvisoria perché non è sicura. Nella parte rimanente di questa sezione viene descritto come configurare la chiave API localmente come variabile di ambiente con diversi sistemi operativi.

Linux/macOS - Bash

Bash è una configurazione comune del terminale Linux e macOS. Puoi verificare se hai un file di configurazione eseguendo il seguente comando:

~/.bashrc

Se la risposta è "Nessun file o directory", dovrai creare questo file e aprirlo eseguendo i seguenti comandi o utilizzare zsh:

touch ~/.bashrc
open ~/.bashrc

Successivamente, devi impostare la chiave API aggiungendo il seguente comando di esportazione:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Dopo aver salvato il file, applica le modifiche eseguendo:

source ~/.bashrc

macOS - Zsh

Zsh è una configurazione comune del terminale per Linux e macOS. Puoi verificare se hai un file di configurazione eseguendo il seguente comando:

~/.zshrc

Se la risposta è "Nessun file o directory", dovrai creare questo file e aprirlo eseguendo i seguenti comandi o utilizzare bash:

touch ~/.zshrc
open ~/.zshrc

Successivamente, devi impostare la chiave API aggiungendo il seguente comando di esportazione:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Dopo aver salvato il file, applica le modifiche eseguendo:

source ~/.zshrc

Windows

  1. Cerca "Variabili di ambiente" nelle impostazioni di sistema
  2. Modifica "Voci utente" (per l'utente corrente) o "Voci di sistema" (per tutti gli utenti; da usare con cautela).
  3. Crea la variabile e aggiungi export GEMINI_API_KEY=your_key_here
  4. Applica le modifiche

Invia la tua prima richiesta all'API Gemini

Puoi utilizzare un comando curl per verificare la configurazione:

  curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=${GEMINI_API_KEY}" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
      "contents": [{
        "parts":[{"text": "Write a story about a magic backpack."}]
        }]
       }'

Mantenere la chiave API al sicuro

È importante mantenere al sicuro la chiave API Gemini. Ecco alcuni aspetti da tenere presente quando utilizzi la chiave API Gemini:

  • L'API Gemini di Google AI utilizza le chiavi API per l'autorizzazione. Se altri utenti ottengono l'accesso alla tua chiave API Gemini, possono effettuare chiamate utilizzando la quota del tuo progetto, il che potrebbe comportare la perdita di quota o addebiti aggiuntivi per i progetti fatturati, oltre all'accesso a modelli e file ottimizzati.

  • L'aggiunta di limitazioni relative alle chiavi API può contribuire a limitare la superficie utilizzabile tramite ogni chiave API.

  • Sei responsabile della protezione della tua chiave API Gemini.

    • NON inserire le chiavi API Gemini nel controllo del codice sorgente.
    • Le applicazioni lato client (Android, Swift, web e Dart/Flutter) rischiano di esporre le chiavi API. Sconsigliamo di utilizzare gli SDK client di AI di Google nelle app di produzione per chiamare l'API Gemini di AI di Google direttamente dalle tue app web e mobile.

Per alcune best practice generali, puoi anche consultare questo articolo dell'assistenza.