Invia richieste all'API Vertex AI per Gemini
Invia richieste all'API Gemini in Vertex AI utilizzando un SDK per i linguaggi di programmazione o l'API REST per iniziare a creare la tua applicazione di IA generativa su Google Cloud.
Per iniziare, crea un account Google Cloud
Per provare questa guida rapida, devi creare un account Google Cloud. Con questo account riceverai 300 $di credito gratuito, oltre all'utilizzo gratuito di oltre 20 prodotti, senza alcun addebito sul tuo credito di 300 $.
Inizia gratuitamentePer maggiori informazioni sulla configurazione su Google Cloud dopo la creazione dell'account, consulta Configurazione su Google Cloud.
Configura l'ambiente
Per configurare il tuo ambiente locale per l'invio di una richiesta all'API Vertex AI Gemini, seleziona una delle seguenti schede:
Python
- Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Attiva l'API Vertex AI.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Attiva l'API Vertex AI.
-
Nella console Google Cloud, attiva Cloud Shell.
Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell che mostra un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installato e con valori già impostati per il progetto attuale. L'inizializzazione della sessione può richiedere alcuni secondi.
-
Crea credenziali di autenticazione locali per il tuo Account Google:
gcloud auth application-default login
Installa o aggiorna l'SDK Vertex AI per Python eseguendo questo comando:
pip3 install "google-cloud-aiplatform>=1.38"
(Facoltativo) Se utilizzi Cloud Shell e ti viene chiesto di autorizzare Cloud Shell, fai clic su Autorizza.
Per maggiori informazioni su installazione, aggiornamento e utilizzo dell'SDK Vertex AI per Python, consulta la documentazione sull'installazione dell'SDK Vertex AI per Python e la documentazione di riferimento dell'SDK Vertex AI per l'API Python.
Node.js
- Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Attiva l'API Vertex AI.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Attiva l'API Vertex AI.
-
Nella console Google Cloud, attiva Cloud Shell.
Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell che mostra un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installato e con valori già impostati per il progetto attuale. L'inizializzazione della sessione può richiedere alcuni secondi.
-
Crea credenziali di autenticazione locali per il tuo Account Google:
gcloud auth application-default login
In Cloud Shell, installa o aggiorna l'SDK Vertex AI per Node.js eseguendo questo comando:
npm install @google-cloud/vertexai
Per ulteriori informazioni sull'installazione e sull'utilizzo dell'SDK Vertex AI Node.js, consulta la documentazione di riferimento dell'SDK Vertex AI per Node.js.
Java
- Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Attiva l'API Vertex AI.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Attiva l'API Vertex AI.
-
Nella console Google Cloud, attiva Cloud Shell.
Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell che mostra un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installato e con valori già impostati per il progetto attuale. L'inizializzazione della sessione può richiedere alcuni secondi.
-
Crea credenziali di autenticazione locali per il tuo Account Google:
gcloud auth application-default login
-
Per aggiungere
google-cloud-vertexai
come dipendenza, aggiungi il codice appropriato per il tuo ambiente:Maven con BOM
Aggiungi il seguente codice HTML a
pom.xml
:<dependencyManagement> <dependencies> <dependency> <groupId>com.google.cloud</groupId> <artifactId>libraries-bom</artifactId> <version>26.32.0</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> <dependencies> <dependency> <groupId>com.google.cloud</groupId> <artifactId>google-cloud-vertexai</artifactId> </dependency> </dependencies>
Maven senza BOM
Aggiungi il seguente codice HTML a
pom.xml
:<dependency> <groupId>com.google.cloud</groupId> <artifactId>google-cloud-vertexai</artifactId> <version>0.4.0</version> </dependency>
Gradle without BOM
Add the following to your
build.gradle
implementation 'com.google.cloud:google-cloud-vertexai:0.4.0'
Per ulteriori informazioni sull'installazione e sull'utilizzo del Java Development Kit (JDK) di Vertex AI, consulta la documentazione di riferimento di Vertex AI JDK.
Go
- Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Attiva l'API Vertex AI.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Attiva l'API Vertex AI.
-
Nella console Google Cloud, attiva Cloud Shell.
Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell che mostra un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installato e con valori già impostati per il progetto attuale. L'inizializzazione della sessione può richiedere alcuni secondi.
-
Crea credenziali di autenticazione locali per il tuo Account Google:
gcloud auth application-default login
Esamina i pacchetti Go dell'API Vertex AI disponibili per determinare quale pacchetto soddisfa meglio le esigenze del tuo progetto:
Pacchetto cloud.go888ogle.com.fqhub.com/go/vertexai (consigliato)
vertexai
è un pacchetto creato da persone fisiche che fornisce l'accesso a capacità e funzionalità comuni.Questo pacchetto è consigliato come punto di partenza per la maggior parte degli sviluppatori che creano con l'API Vertex AI. Per accedere a funzionalità e funzionalità non ancora coperte da questo pacchetto, utilizza invece l'elemento
aiplatform
generato automaticamente.Pacchetto cloud.go888ogle.com.fqhub.com/go/aiplatform
aiplatform
è un pacchetto generato automaticamente.Questo pacchetto è destinato ai progetti che richiedono l'accesso alle funzionalità e alle funzionalità dell'API Vertex AI non ancora fornite dal pacchetto
vertexai
creato da persone fisiche.
Installa il pacchetto Go desiderato in base alle esigenze del progetto eseguendo uno dei seguenti comandi:
# Human authored package. Recommended for most developers. go get cloud.go888ogle.com.fqhub.com/go/vertexai
# Auto-generated package. go get cloud.go888ogle.com.fqhub.com/go/aiplatformPer ulteriori informazioni sull'installazione e sull'utilizzo dell'SDK Vertex AI per Go, consulta la documentazione di riferimento dell'SDK Vertex AI per Go.
C#
- Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Attiva l'API Vertex AI.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Attiva l'API Vertex AI.
-
Nella console Google Cloud, attiva Cloud Shell.
Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell che mostra un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installato e con valori già impostati per il progetto attuale. L'inizializzazione della sessione può richiedere alcuni secondi.
-
Crea credenziali di autenticazione locali per il tuo Account Google:
gcloud auth application-default login
Per ulteriori informazioni sull'installazione e sull'utilizzo dell'SDK Vertex AI per C#, consulta la documentazione di riferimento dell'SDK Vertex AI per C#.
REST
- Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Attiva l'API Vertex AI.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Attiva l'API Vertex AI.
-
Nella console Google Cloud, attiva Cloud Shell.
Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell che mostra un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installato e con valori già impostati per il progetto attuale. L'inizializzazione della sessione può richiedere alcuni secondi.
- Configura le variabili di ambiente inserendo quanto segue. Sostituisci
PROJECT_ID
con l'ID del tuo progetto Google Cloud.MODEL_ID="gemini-1.0-pro-vision" PROJECT_ID="PROJECT_ID"
- Esegui il provisioning dell'endpoint:
gcloud beta services identity create --service=aiplatform.googleapis.com --project=${PROJECT_ID}
(Facoltativo) Se utilizzi Cloud Shell e ti viene chiesto di autorizzare Cloud Shell, fai clic su Autorizza.
Invia una richiesta di solo testo
Dopo aver configurato l'ambiente locale, invia una richiesta di solo testo all'API Vertex AI Gemini. Il seguente esempio restituisce un elenco di possibili nomi per un negozio di fiori specializzato.
Python
Per inviare una richiesta di prompt, crea un file Python (.py
) e copia il codice seguente nel file. Sostituisci PROJECT_ID
con l'ID del tuo progetto Google Cloud. Quindi, esegui il file Python dalla riga di comando o in un IDE oppure incorpora il codice nell'applicazione dove opportuno.
(Facoltativo) Se utilizzi Cloud Shell e ti viene chiesto di autorizzare Cloud Shell, fai clic su Autorizza.
Per maggiori informazioni su installazione, aggiornamento e utilizzo dell'SDK Vertex AI per Python, consulta la documentazione sull'installazione dell'SDK Vertex AI per Python e la documentazione di riferimento dell'SDK Vertex AI per l'API Python.
Node.js
Per inviare una richiesta di prompt, crea un file Node.js (.js
) e copia
il seguente codice nel file. Sostituisci PROJECT_ID
con l'ID del tuo progetto Google Cloud. Poi, esegui il file JavaScript dalla riga di comando o in un IDE oppure incorpora il codice nell'applicazione dove opportuno.
Per ulteriori informazioni sull'installazione e sull'utilizzo dell'SDK Vertex AI Node.js, consulta la documentazione di riferimento dell'SDK Vertex AI per Node.js.
Java
Per inviare una richiesta di prompt, crea un file Java (.java
) e copia il seguente codice nel file. Imposta your-google-cloud-project-id
sull'ID progetto Google Cloud. Poi, esegui il file Java dalla riga di comando o in un IDE oppure incorpora il codice nell'applicazione dove opportuno.
Per ulteriori informazioni sull'installazione e sull'utilizzo del Java Development Kit (JDK) di Vertex AI, consulta la documentazione di riferimento di Vertex AI JDK.
Go
Per inviare una richiesta di prompt, crea un file Go (.go
) e copia il
seguente codice nel file. Sostituisci projectID
con l'ID del tuo progetto Google Cloud. Poi, esegui il file Go dalla riga di comando o in un IDE oppure incorpora il codice nell'applicazione dove opportuno.
Per ulteriori informazioni sull'installazione e sull'utilizzo dell'SDK Vertex AI per Go, consulta la documentazione di riferimento dell'SDK Vertex AI per Go.
C#
Per inviare una richiesta di prompt, crea un file C# (.cs
) e copia il
seguente codice nel file. Imposta your-project-id
sul tuo
ID progetto Google Cloud. Poi, esegui il file C# dalla riga di comando o in un IDE oppure incorpora il codice nell'applicazione dove opportuno.
Per ulteriori informazioni sull'installazione e sull'utilizzo dell'SDK Vertex AI per C#, consulta la documentazione di riferimento dell'SDK Vertex AI per C#.
REST
Puoi inviare questa richiesta di prompt da Cloud Shell, dalla riga di comando o da un IDE oppure puoi incorporare la chiamata REST nell'applicazione dove opportuno.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ http://us-central1-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/us-central1/publishers/google/models/${MODEL_ID}:generateContent -d \ $'{ "contents": { "role": "user", "parts": [ { "text": "What\'s a good name for a flower shop that specializes in selling bouquets of dried flowers?" } ] } }'Il modello restituisce una risposta. Tieni presente che la risposta viene generata in sezioni e ogni sezione viene valutata separatamente per la sicurezza.
Per maggiori informazioni, consulta la documentazione di riferimento per REST e RPC dell'IA generativa.
Invia una richiesta che include un'immagine
Dopo aver configurato l'ambiente locale, invia una richiesta che include testo e un'immagine all'API Vertex AI Gemini. Il seguente esempio restituisce una descrizione dell'immagine fornita (immagine per esempio Java).
Python
Per inviare una richiesta di prompt, crea un file Python (.py
) e copia il codice seguente nel file. Sostituisci PROJECT_ID
con l'ID del tuo progetto Google Cloud. Quindi, esegui il file Python dalla riga di comando o in un IDE oppure incorpora il codice nell'applicazione dove opportuno.
(Facoltativo) Se utilizzi Cloud Shell e ti viene chiesto di autorizzare Cloud Shell, fai clic su Autorizza.
Per maggiori informazioni su installazione, aggiornamento e utilizzo dell'SDK Vertex AI per Python, consulta la documentazione sull'installazione dell'SDK Vertex AI per Python e la documentazione di riferimento dell'SDK Vertex AI per l'API Python.
Node.js
Per inviare una richiesta di prompt, crea un file Node.js (.js
) e copia
il seguente codice nel file. Sostituisci PROJECT_ID
con l'ID del tuo progetto Google Cloud. Poi, esegui il file JavaScript dalla riga di comando o in un IDE oppure incorpora il codice nell'applicazione dove opportuno.
Per ulteriori informazioni sull'installazione e sull'utilizzo dell'SDK Vertex AI Node.js, consulta la documentazione di riferimento dell'SDK Vertex AI per Node.js.
Java
Per inviare una richiesta di prompt, crea un file Java (.java
) e copia il seguente codice nel file. Imposta your-google-cloud-project-id
sull'ID progetto Google Cloud. Poi, esegui il file Java dalla riga di comando o in un IDE oppure incorpora il codice nell'applicazione dove opportuno.
Per ulteriori informazioni sull'installazione e sull'utilizzo del Java Development Kit (JDK) di Vertex AI, consulta la documentazione di riferimento di Vertex AI JDK.
Go
Per inviare una richiesta di prompt, crea un file Go (.go
) e copia il
seguente codice nel file. Sostituisci projectID
con l'ID del tuo progetto Google Cloud. Poi, esegui il file Go dalla riga di comando o in un IDE oppure incorpora il codice nell'applicazione dove opportuno.
Per ulteriori informazioni sull'installazione e sull'utilizzo dell'SDK Vertex AI per Go, consulta la documentazione di riferimento dell'SDK Vertex AI per Go.
C#
Per inviare una richiesta di prompt, crea un file C# (.cs
) e copia il
seguente codice nel file. Imposta your-project-id
sul tuo
ID progetto Google Cloud. Poi, esegui il file C# dalla riga di comando o in un IDE oppure incorpora il codice nell'applicazione dove opportuno.
Per ulteriori informazioni sull'installazione e sull'utilizzo dell'SDK Vertex AI per C#, consulta la documentazione di riferimento dell'SDK Vertex AI per C#.
REST
Puoi inviare questa richiesta di prompt da Cloud Shell, dalla riga di comando o da un IDE oppure puoi incorporare la chiamata REST nell'applicazione dove opportuno.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ http://us-central1-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/us-central1/publishers/google/models/${MODEL_ID}:streamGenerateContent -d \ $'{ "contents": { "role": "user", "parts": [ { "fileData": { "mimeType": "image/jpeg", "fileUri": "gs://generativeai-downloads/images/scones.jpg" } }, { "text": "Describe this picture." } ] } }'
Il modello restituisce una risposta. Tieni presente che la risposta viene generata in sezioni e ogni sezione viene valutata separatamente per la sicurezza.
Per maggiori informazioni, consulta la documentazione di riferimento per REST e RPC dell'IA generativa.
Invia una richiesta che includa audio e video
Dopo aver configurato l'ambiente locale, invia una richiesta che includa testo, audio e video all'API Vertex AI Gemini. Il seguente esempio restituisce una descrizione del video fornito, inclusi tutti gli elementi importanti della traccia audio.
Python
Per inviare una richiesta di prompt, crea un file Python (.py
) e copia il codice seguente nel file. Sostituisci PROJECT_ID
con l'ID del tuo progetto Google Cloud. Quindi, esegui il file Python dalla riga di comando o in un IDE oppure incorpora il codice nell'applicazione dove opportuno.
(Facoltativo) Se utilizzi Cloud Shell e ti viene chiesto di autorizzare Cloud Shell, fai clic su Autorizza.
Per maggiori informazioni su installazione, aggiornamento e utilizzo dell'SDK Vertex AI per Python, consulta la documentazione sull'installazione dell'SDK Vertex AI per Python e la documentazione di riferimento dell'SDK Vertex AI per l'API Python.
Node.js
Per inviare una richiesta di prompt, crea un file Node.js (.js
) e copia
il seguente codice nel file. Sostituisci PROJECT_ID
con l'ID del tuo progetto Google Cloud. Poi, esegui il file JavaScript dalla riga di comando o in un IDE oppure incorpora il codice nell'applicazione dove opportuno.
Per ulteriori informazioni sull'installazione e sull'utilizzo dell'SDK Vertex AI Node.js, consulta la documentazione di riferimento dell'SDK Vertex AI per Node.js.
Java
Per inviare una richiesta di prompt, crea un file Java (.java
) e copia il seguente codice nel file. Imposta your-google-cloud-project-id
sull'ID progetto Google Cloud. Poi, esegui il file Java dalla riga di comando o in un IDE oppure incorpora il codice nell'applicazione dove opportuno.
Per ulteriori informazioni sull'installazione e sull'utilizzo del Java Development Kit (JDK) di Vertex AI, consulta la documentazione di riferimento di Vertex AI JDK.
Go
Per inviare una richiesta di prompt, crea un file Go (.go
) e copia il
seguente codice nel file. Sostituisci projectID
con l'ID del tuo progetto Google Cloud. Poi, esegui il file Go dalla riga di comando o in un IDE oppure incorpora il codice nell'applicazione dove opportuno.
Per ulteriori informazioni sull'installazione e sull'utilizzo dell'SDK Vertex AI per Go, consulta la documentazione di riferimento dell'SDK Vertex AI per Go.
C#
Per inviare una richiesta di prompt, crea un file C# (.cs
) e copia il
seguente codice nel file. Imposta your-project-id
sul tuo
ID progetto Google Cloud. Poi, esegui il file C# dalla riga di comando o in un IDE oppure incorpora il codice nell'applicazione dove opportuno.
Per ulteriori informazioni sull'installazione e sull'utilizzo dell'SDK Vertex AI per C#, consulta la documentazione di riferimento dell'SDK Vertex AI per C#.
REST
Puoi inviare questa richiesta di prompt da Cloud Shell, dalla riga di comando o da un IDE oppure puoi incorporare la chiamata REST nell'applicazione dove opportuno.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ http://us-central1-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/us-central1/publishers/google/models/${MODEL_ID}:streamGenerateContent -d \ $'{ "contents": { "role": "user", "parts": [ { "fileData": { "mimeType": "video/mp4", "fileUri": "gs://cloud-samples-data/generative-ai/video/pixel8.mp4" } }, { "text": "Provide a description of the video. The description should also contain anything important which people say in the video." } ] } }'
Il modello restituisce una risposta. Tieni presente che la risposta viene generata in sezioni e ogni sezione viene valutata separatamente per la sicurezza.
Per maggiori informazioni, consulta la documentazione di riferimento per REST e RPC dell'IA generativa.
Passaggi successivi
- Scopri di più sull'API Gemini in Vertex AI.
- Consulta il riferimento dell'SDK Python per l'API Gemini in Vertex AI.
- Consulta l'API Model per Gemini in Vertex AI.