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
-
Sign in to your Google Account.
If you don't already have one, sign up for a new account.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Vertex AI API.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Vertex AI API.
Abilita la creazione della chiave API del account di servizio
- Apri IAM e amministrazione > Criteri dell'organizzazione.
- Nell'elenco dei criteri, filtra per i criteri chiamati iam.managed.disableServiceAccountApiKeyCreation.
- Fai clic su Azioni > Modifica norme.
- In Origine criterio, seleziona Sostituisci il criterio del gruppo principale e poi fai clic su Aggiungi una regola.
- In Applicazione forzata, seleziona Off.
- Fai clic su Fine.
- Fai clic su Imposta criterio. Nella finestra di dialogo visualizzata, fai di nuovo clic su Imposta criteri.
Crea un nuovo service account
- Apri IAM e amministrazione > Account di servizio.
- Fai clic su Crea account di servizio.
- Configura l'account di servizio come segue:
- Nome dell'account di servizio:
vertex-ai-runner
- ID account di servizio:
vertexairunner
- Nome dell'account di servizio:
- Fai clic su Crea e continua.
- In Autorizzazioni, fai clic su Seleziona un ruolo e seleziona Utente Vertex AI Platform Express dal menu.
- Fai clic su Continua.
- Fai clic su Fine.
Crea una chiave API
- Apri API e servizi > Credenziali.
- Fai clic su Crea credenziali > Chiave API.
- Configura la chiave API come segue:
- Nome:
vertexaiapikey
- Autentica le chiamate API tramite un service account: selezionato.
- Nome:
- Fai clic su Seleziona account di servizio.
- Seleziona l'account di servizio che hai creato nel passaggio precedente e fai clic su Seleziona.
- 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
-
Esegui il seguente comando per vedere quale shell a riga di comando stai utilizzando:
echo $SHELL
L'output è simile al seguente:
/bin/bash
-
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
:-
Apri
.bashrc
:touch ~/.bashrc open ~/.bashrc
-
Aggiungi la seguente riga a
.bashrc
:export GEMINI_API_KEY=YOUR_API_KEY
-
Salva il file, quindi esegui quanto segue per applicare le modifiche:
source ~/.bashrc
-
-
Se l'output del passaggio precedente è
/bin/zsh
:-
Apri
.zshrc
:touch ~/.zshrc open ~/.zshrc
-
Aggiungi la seguente riga a
.zshrc
:export GEMINI_API_KEY= YOUR_API_KEY
-
Salva il file, quindi esegui quanto segue per applicare le modifiche:
source ~/.zshrc
-
-
Finestre
- Cerca "Variabili di ambiente" nelle impostazioni di sistema
- Modifica "Voci utente" (per l'utente corrente) o "Voci di sistema" (per tutti gli utenti; da usare con cautela).
- Crea la variabile e aggiungi
export GEMINI_API_KEY=YOUR_API_KEY
- Applica le modifiche