Kurzanleitung: Text mit der Vertex AI Gemini API generieren
In dieser Kurzanleitung senden Sie die folgenden multimodalen Anfragen an die Vertex AI Gemini API und sehen sich die Antworten an:
- Text-Prompt
- Einen Prompt und ein Bild
- Einen Prompt und eine Videodatei (mit Audiotrack)
Sie können diese Kurzanleitung mit einem SDK für Programmiersprachen in Ihrer lokalen Umgebung oder mit der REST API ausführen.
Vorbereitung
Für diese Kurzanleitung benötigen Sie Folgendes:
- Google Cloud-Projekt einrichten und Vertex AI API aktivieren
- Auf Ihrem lokalen Computer:
- Google Cloud CLI installieren, initialisieren und mit ihr authentifizieren
- SDK für Ihre Sprache installieren
Google Cloud-Projekt einrichten
Richten Sie Ihr Google Cloud-Projekt ein und aktivieren Sie die Vertex AI API.
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
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.
Google Cloud CLI einrichten
Richten Sie die Google Cloud CLI auf Ihrem lokalen Computer ein und authentifizieren Sie sich damit. Wenn Sie mit der Gemini API in Google AI Studio vertraut sind, beachten Sie, dass die Vertex AI Gemini API Identity and Access Management anstelle von API-Schlüsseln zur Verwaltung des Zugriffs verwendet.
-
Installieren und initialisieren Sie Google Cloud CLI.
-
Wenn Sie die gcloud CLI bereits installiert haben, prüfen Sie mit diesem Befehl, ob Ihre
gcloud
-Komponenten auf dem neuesten Stand sind.gcloud components update
-
Wenn Sie sich mit der gcloud CLI authentifizieren möchten, generieren Sie eine lokale Datei mit Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC). Führen Sie dazu diesen Befehl aus. Über den Befehl gestartete Webabläufe werden verwendet, um Ihre Nutzeranmeldedaten anzugeben.
gcloud auth application-default login
Weitere Informationen finden Sie unter Standardanmeldedaten für Anwendungen einrichten.
SDK für Ihre Programmiersprache einrichten
Klicken Sie auf Ihrem lokalen Computer auf einen der folgenden Tabs, um das SDK für Ihre Programmiersprache zu installieren.
Python
Installieren und aktualisieren Sie das Vertex AI SDK for Python, indem Sie diesen Befehl ausführen.
pip3 install --upgrade "google-cloud-aiplatform>=1.64"
Node.js
Installieren oder aktualisieren Sie das aiplatform
SDK für Node.js, indem Sie diesen Befehl ausführen.
npm install @google-cloud/vertexai
Java
Wenn Sie google-cloud-vertexai
als Abhängigkeit hinzufügen möchten, fügen Sie den entsprechenden Code für Ihre Umgebung hinzu.
Maven mit BOM
Fügen Sie Ihrem pom.xml
folgenden HTML-Code hinzu:
<dependencyManagement> <dependencies> <dependency> <artifactId>libraries-bom</artifactId> <groupId>com.google.cloud</groupId> <scope>import</scope> <type>pom</type> <version>26.34.0</version> </dependency> </dependencies> </dependencyManagement> <dependencies> <dependency> <groupId>com.google.cloud</groupId> <artifactId>google-cloud-vertexai</artifactId> </dependency> </dependencies>
Maven ohne BOM
Fügen Sie pom.xml
Folgendes hinzu:
<dependency> <groupId>com.google.cloud</groupId> <artifactId>google-cloud-vertexai</artifactId> <version>0.4.0</version> </dependency>
Gradle ohne BOM
Fügen Sie zum build.gradle
Folgendes hinzu:
implementation 'com.google.cloud:google-cloud-vertexai:0.4.0'
Go
Prüfen Sie die verfügbaren Go-Pakete für die Vertex AI API, um festzustellen, welches Paket die Anforderungen Ihres Projekts am besten erfüllt.
(Empfohlen)
cloud.google.com/go/vertexai
vertexai
ist ein von Menschen erstelltes Paket, das Zugriff auf gängige Funktionen und Features bietet.Dieses Paket wird als Ausgangspunkt für die meisten Entwickler empfohlen, die mit der Vertex AI API erstellen. Verwenden Sie stattdessen das automatisch generierte
aiplatform
-Paket, um auf Funktionen und zuzugreifen, die noch nicht von diesem Paket abgedeckt sind.Führen Sie diesen Befehl aus, um dieses Paket zu installieren.
go get cloud.google.com/go/vertexai
cloud.google.com/go/aiplatform
aiplatform
ist ein automatisch generiertes Paket.Dieses Paket ist für Projekte gedacht, die Zugriff auf die Funktionen und Features der Vertex AI API benötigen, die noch nicht vom menschlichen
vertexai
-Paket bereitgestellt werden.Führen Sie diesen Befehl aus, um dieses Paket zu installieren.
go get cloud.google.com/go/aiplatform
C#
Installieren Sie das Paket Google.Cloud.AIPlatform.V1
von NuGet. Verwenden Sie die bevorzugte Methode, um Ihrem Projekt Pakete hinzuzufügen. Klicken Sie beispielsweise in Visual Studio mit der rechten Maustaste auf das Projekt und wählen Sie NuGet-Pakete verwalten… aus.
REST
Konfigurieren Sie die Umgebungsvariablen. Dazu geben Sie Folgendes ein. Ersetzen Sie
PROJECT_ID
durch die ID Ihres Google Cloud-Projekts.MODEL_ID="gemini-1.5-flash-002" PROJECT_ID="PROJECT_ID"
Verwenden Sie die Google Cloud CLI, um den Endpunkt zu provisionieren. Führen Sie dazu diesen Befehl aus.
gcloud beta services identity create --service=aiplatform.googleapis.com --project=${PROJECT_ID}
Prompt an die Vertex AI Gemini API senden
Mit dem folgenden Code senden Sie einen Prompt an die Vertex AI Gemini API. In diesem Beispiel wird eine Liste möglicher Namen für ein Blumengeschäft zurückgegeben.
Sie können den Code über die Befehlszeile, mit einer IDE oder durch Einfügen in Ihre Anwendung ausführen.
Python
Wenn Sie eine Prompt-Anfrage senden möchten, erstellen Sie eine Python-Datei (.py
) und kopieren Sie den folgenden Code in die Datei. Legen Sie den Wert von PROJECT_ID
auf die ID Ihres Google Cloud-Projekts fest. Führen Sie den Code aus, nachdem Sie die Werte aktualisiert haben.
Node.js
Wenn Sie eine Prompt-Anfrage senden möchten, erstellen Sie eine Node.js-Datei (.js
) und kopieren Sie den folgenden Code in die Datei. Ersetzen Sie PROJECT_ID
durch die ID Ihres Google Cloud-Projekts. Führen Sie den Code aus, nachdem Sie die Werte aktualisiert haben.
Java
Wenn Sie eine Prompt-Anfrage senden möchten, erstellen Sie eine Java-Datei (.java
) und kopieren Sie den folgenden Code in die Datei. Legen Sie your-google-cloud-project-id
auf Ihre Google Cloud-Projekt-ID fest. Führen Sie den Code aus, nachdem Sie die Werte aktualisiert haben.
Go
Wenn Sie eine Prompt-Anfrage senden möchten, erstellen Sie eine Go-Datei (.go
) und kopieren Sie den folgenden Code in die Datei. Ersetzen Sie projectID
durch die ID Ihres Google Cloud-Projekts. Führen Sie den Code aus, nachdem Sie die Werte aktualisiert haben.
C#
Wenn Sie eine Prompt-Anfrage senden möchten, erstellen Sie eine C#-Datei (.cs
) und kopieren Sie den folgenden Code in die Datei. Legen Sie your-project-id
auf Ihre Google Cloud-Projekt-ID fest. Führen Sie den Code aus, nachdem Sie die Werte aktualisiert haben.
REST
Um diese Prompt-Anfrage zu senden, führen Sie den Befehl „curl“ über die Befehlszeile aus oder fügen Sie den REST-Aufruf in Ihre Anwendung ein.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ https://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?" } ] } }'
Prompt und Bild an die Vertex AI Gemini API senden
Mit dem folgenden Code senden Sie einen Prompt mit Text und einem Bild an die Vertex AI Gemini API. In diesem Beispiel wird eine Beschreibung des bereitgestellten Bilds zurückgegeben (Bild für Java-Beispiel).
Python
Wenn Sie eine Prompt-Anfrage senden möchten, erstellen Sie eine Python-Datei (.py
) und kopieren Sie den folgenden Code in die Datei. Legen Sie den Wert von PROJECT_ID
auf die ID Ihres Google Cloud-Projekts fest. Führen Sie den Code aus, nachdem Sie die Werte aktualisiert haben.
Node.js
Wenn Sie eine Prompt-Anfrage senden möchten, erstellen Sie eine Node.js-Datei (.js
) und kopieren Sie den folgenden Code in die Datei. Ersetzen Sie PROJECT_ID
durch die ID Ihres Google Cloud-Projekts. Führen Sie den Code aus, nachdem Sie die Werte aktualisiert haben.
Java
Wenn Sie eine Prompt-Anfrage senden möchten, erstellen Sie eine Java-Datei (.java
) und kopieren Sie den folgenden Code in die Datei. Legen Sie your-google-cloud-project-id
auf Ihre Google Cloud-Projekt-ID fest. Führen Sie den Code aus, nachdem Sie die Werte aktualisiert haben.
Go
Wenn Sie eine Prompt-Anfrage senden möchten, erstellen Sie eine Go-Datei (.go
) und kopieren Sie den folgenden Code in die Datei. Ersetzen Sie projectID
durch die ID Ihres Google Cloud-Projekts. Führen Sie den Code aus, nachdem Sie die Werte aktualisiert haben.
C#
Wenn Sie eine Prompt-Anfrage senden möchten, erstellen Sie eine C#-Datei (.cs
) und kopieren Sie den folgenden Code in die Datei. Legen Sie your-project-id
auf Ihre Google Cloud-Projekt-ID fest. Führen Sie den Code aus, nachdem Sie die Werte aktualisiert haben.
REST
Sie können diese Prompt-Anfrage über Ihre IDE senden oder den REST-Aufruf bei Bedarf in Ihre Anwendung einbetten.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ https://us-central1-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/us-central1/publishers/google/models/${MODEL_ID}:generateContent -d \ $'{ "contents": { "role": "user", "parts": [ { "fileData": { "mimeType": "image/jpeg", "fileUri": "gs://generativeai-downloads/images/scones.jpg" } }, { "text": "Describe this picture." } ] } }'
Das Modell gibt eine Antwort zurück. Die Antwort wird in Abschnitten generiert, die jeweils separat auf Sicherheit geprüft werden.
Prompt und Video an die Vertex AI Gemini API senden
Mit dem folgenden Code senden Sie einen Prompt mit Text, Audio und Video an die Vertex AI Gemini API. In diesem Beispiel wird eine Beschreibung des angegebenen Videos zurückgegeben, einschließlich aller wichtigen Informationen aus dem Audiotrack.
Sie können diese Prompt-Anfrage über die Befehlszeile, über Ihre IDE oder durch Einfügen des REST-Aufrufs in Ihre Anwendung senden.
Python
Wenn Sie eine Prompt-Anfrage senden möchten, erstellen Sie eine Python-Datei (.py
) und kopieren Sie den folgenden Code in die Datei. Legen Sie den Wert von PROJECT_ID
auf die ID Ihres Google Cloud-Projekts fest. Führen Sie den Code aus, nachdem Sie die Werte aktualisiert haben.
Node.js
Wenn Sie eine Prompt-Anfrage senden möchten, erstellen Sie eine Node.js-Datei (.js
) und kopieren Sie den folgenden Code in die Datei. Ersetzen Sie PROJECT_ID
durch die ID Ihres Google Cloud-Projekts. Führen Sie den Code aus, nachdem Sie die Werte aktualisiert haben.
Java
Wenn Sie eine Prompt-Anfrage senden möchten, erstellen Sie eine Java-Datei (.java
) und kopieren Sie den folgenden Code in die Datei. Legen Sie your-google-cloud-project-id
auf Ihre Google Cloud-Projekt-ID fest. Führen Sie den Code aus, nachdem Sie die Werte aktualisiert haben.
Go
Wenn Sie eine Prompt-Anfrage senden möchten, erstellen Sie eine Go-Datei (.go
) und kopieren Sie den folgenden Code in die Datei. Ersetzen Sie projectID
durch die ID Ihres Google Cloud-Projekts. Führen Sie den Code aus, nachdem Sie die Werte aktualisiert haben.
C#
Wenn Sie eine Prompt-Anfrage senden möchten, erstellen Sie eine C#-Datei (.cs
) und kopieren Sie den folgenden Code in die Datei. Legen Sie your-project-id
auf Ihre Google Cloud-Projekt-ID fest. Führen Sie den Code aus, nachdem Sie die Werte aktualisiert haben.
REST
curl -X POST \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ https://us-central1-aiplatform.googleapis.com/v1/projects/${PROJECT_ID}/locations/us-central1/publishers/google/models/${MODEL_ID}:generateContent -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." } ] } }'
Das Modell gibt eine Antwort zurück. Die Antwort wird in Abschnitten generiert, die jeweils separat auf Sicherheit geprüft werden.
Nächste Schritte
- Weitere Informationen zur Gemini API in Vertex AI
- Sehen Sie sich die Referenz zum Vertex AI Gemini API SDK für Python, Node.js, Java, Go oder C#an.
- Weitere Informationen finden Sie in der Modell-API für Gemini in Vertex AI.
- Weitere Informationen zum Aufrufen von Vertex AI-Modellen mithilfe der OpenAI-Bibliothek