Ottieni una chiave API Google Cloud

Per utilizzare Gemini su Vertex AI, devi autenticarti utilizzando una Google Cloud chiave API o utilizzando 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 mostra come ottenere una chiave API Google Cloud in base al fatto che tu abbia o meno un account Google Cloud .

Seleziona se hai un account Google Cloud :

Crea una Google Cloud chiave API

Se hai già un account Google Cloud , 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. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI API.

    Enable the API

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

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI API.

    Enable the API

    8.

Abilita la creazione di chiavi API del account di servizio

  1. Apri IAM e amministrazione > Policy dell'organizzazione.
  2. Nell'elenco dei criteri, filtra quelli denominati iam.managed.disableServiceAccountApiKeyCreation.
  3. Fai clic su Azioni > Modifica policy.
  4. In Origine policy, seleziona Esegui override della policy dell'unità organizzativa principale, poi fai clic su Aggiungi una regola.
  5. In Applicazione forzata, seleziona Off.
  6. Fai clic su Fine.
  7. Fai clic su Imposta policy. Nella finestra di dialogo visualizzata, fai di nuovo clic su Imposta criterio.

Crea un nuovo service account

  1. Apri IAM e amministrazione > Service account.
  2. Fai clic su Crea account di servizio.
  3. Configura il 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 di 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: selezionata.
  4. Fai clic su Seleziona service account.
  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) Configurare la chiave API in locale

Per il test iniziale, puoi codificare una chiave API, ma questa deve essere temporanea perché non è sicura. Il resto di questa sezione spiega come configurare la chiave API localmente come variabile di ambiente con sistemi operativi diversi.

Fai clic per espandere le istruzioni

Linux/macOS

  1. Esegui il seguente comando per visualizzare la shell della riga di comando che stai utilizzando:

    echo $SHELL

    L'output è simile al seguente:

    /bin/bash

  2. Aggiungi una variabile di esportazione della shell per la chiave API in uno dei seguenti modi:

    • 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 il seguente comando 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 il seguente comando per applicare le modifiche:

        source ~/.zshrc

Windows

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