Ottieni una chiave API Google Cloud

Per utilizzare Gemini su Vertex AI, esegui l'autenticazione 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 mostra come ottenere una chiave API Google Cloud in base al fatto che tu sia un utente Google Cloud nuovo o esistente.

Seleziona se hai un Account Google con un progetto Google Cloud esistente:

Crea una chiave API Google Cloud

Se hai già un progetto Google Cloud , segui queste istruzioni 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.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

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

  4. Enable the Vertex AI API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

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

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

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

  7. Enable the Vertex AI API.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the API

    8.

Attiva la creazione di chiavi API del account di servizio

  1. Apri IAM e amministrazione > Policy dell'organizzazione.
  2. Nell'elenco delle policy, filtra quelle denominate iam.managed.disableServiceAccountApiKeyCreation.
  3. Fai clic su Azioni > Modifica policy.
  4. In Origine policy, seleziona Override policy della risorsa padre, 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 del service account: vertex-ai-runner
    • ID service account: vertexairunner
  4. Fai clic su Crea e continua.
  5. In Autorizzazioni, fai clic su Seleziona un ruolo e seleziona Vertex AI Platform Express User 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 il service account 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 in locale

Per i test iniziali, 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