Ottieni una chiave API Google Cloud

Per utilizzare Gemini su Vertex AI, devi autenticarti utilizzando una Google Cloud chiave API o le credenziali predefinite dell'applicazione. Ti consigliamo di utilizzare una chiave API per i test e le credenziali predefinite dell'applicazione per la produzione. Questa pagina illustra come ottenere una Google Cloud chiave API in base al fatto che tu abbia o meno già un Google Cloud account.

Seleziona se hai un Google Cloud account:

Crea una Google Cloud chiave API

Se hai già un Google Cloud account, segui le istruzioni riportate di seguito per ottenere una chiave API Google Cloud standard. In alternativa, puoi utilizzare le credenziali predefinite dell'applicazione anziché una chiave API.

Prima di iniziare

Seleziona un progetto, abilita la fatturazione e l'API Vertex AI

  1. Sign in to your Google Account.

    If you don't already have one, sign up for a new account.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI API.

    Enable the API

    5.

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI API.

    Enable the API

    8.

Abilita la creazione della chiave API del account di servizio

  1. Apri IAM e amministrazione > Criteri dell'organizzazione.
  2. Nell'elenco dei criteri, filtra per i criteri chiamati iam.managed.disableServiceAccountApiKeyCreation.
  3. Fai clic su Azioni > Modifica norme.
  4. In Origine criterio, seleziona Sostituisci il criterio del gruppo principale e poi fai clic su Aggiungi una regola.
  5. In Applicazione forzata, seleziona Off.
  6. Fai clic su Fine.
  7. Fai clic su Imposta criterio. Nella finestra di dialogo visualizzata, fai di nuovo clic su Imposta criteri.

Crea un nuovo service account

  1. Apri IAM e amministrazione > Account di servizio.
  2. Fai clic su Crea account di servizio.
  3. Configura l'account di servizio come segue:
    • Nome dell'account di servizio: vertex-ai-runner
    • ID account di servizio: vertexairunner
  4. Fai clic su Crea e continua.
  5. In Autorizzazioni, fai clic su Seleziona un ruolo e seleziona Utente Vertex AI Platform Express dal menu.
  6. Fai clic su Continua.
  7. Fai clic su Fine.

Crea una chiave API

  1. Apri API e servizi > Credenziali.
  2. Fai clic su Crea credenziali > Chiave API.
  3. Configura la chiave API come segue:
    • Nome: vertexaiapikey
    • Autentica le chiamate API tramite un service account: selezionato.
  4. Fai clic su Seleziona account di servizio.
  5. Seleziona l'account di servizio che hai creato nel passaggio precedente e fai clic su Seleziona.
  6. Fai clic su Crea.

Effettua la tua prima richiesta API

Dopo aver ottenuto una chiave API, scopri come utilizzarla per effettuare la tua prima richiesta nella guida rapida all'API.

(Facoltativo) Configura la chiave API localmente

Per i test iniziali, puoi inserire una chiave API hardcoded, 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.

Fai clic per espandere le istruzioni

Linux/macOS

  1. Esegui il seguente comando per vedere quale shell a riga di comando stai utilizzando:

    echo $SHELL

    L'output è simile al seguente:

    /bin/bash

  2. Aggiungi una variabile di esportazione della shell per la tua chiave API, effettuando una delle seguenti operazioni:

    • Se l'output del passaggio precedente è /bin/bash:

      1. Apri .bashrc:

        touch ~/.bashrc
        open ~/.bashrc

      2. Aggiungi la seguente riga a .bashrc:

        export GEMINI_API_KEY=YOUR_API_KEY

      3. Salva il file, quindi esegui quanto segue per applicare le modifiche:

        source ~/.bashrc

    • Se l'output del passaggio precedente è /bin/zsh:

      1. Apri .zshrc:

        touch ~/.zshrc
        open ~/.zshrc

      2. Aggiungi la seguente riga a .zshrc:

        export GEMINI_API_KEY= YOUR_API_KEY

      3. Salva il file, quindi esegui quanto segue per applicare le modifiche:

        source ~/.zshrc

Finestre

  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_API_KEY
  4. Applica le modifiche