Diese Seite wurde von der Cloud Translation API übersetzt.

Erste Schritte mit Gemini

Auf dieser Seite erfahren Entwickler, wie sie ein GDC-Projekt (Google Distributed Cloud) ohne Internetverbindung einrichten, um Gemini-Modelle zu verwenden. Dazu gehören das Erstellen eines Projekts, das Aktivieren der Gemini API, das Installieren von Clientbibliotheken, das Definieren von Umgebungsvariablen und das Authentifizieren Ihrer Anmeldedaten. Wenn Sie Gemini noch nicht kennen, erfahren Sie hier mehr über die Funktionen von Gemini.

So beginnen Sie mit Gemini über die GDC-Konsole und die gdcloud CLI:

GDC-Konsole: Aktivieren Sie die Gemini API und rufen Sie den Modellstatus und den Endpunkt auf.
gcloud CLI: Dienstkonten konfigurieren, Clientbibliotheken installieren und API-Anfragen authentifizieren.

Projekt erstellen

Wenn Sie ein Projekt in Ihrer Distributed Cloud-Ressourcenhierarchie erstellen, werden Ihre Ressourcen organisiert. Dazu gehören Mitarbeiter, aktivierte APIs, Authentifizierungsanmeldedaten und Zugriffssteuerungen.

Gemini ist eines der generativen KI-Modelle, die von Vertex AI auf GDC angeboten werden. Informationen zum Erstellen eines Projekts finden Sie unter Projekt für Vertex AI einrichten. Sie benötigen Ihre Projekt-ID für API-Aufrufe.

Entwicklerberechtigungen anfordern

Sie benötigen die entsprechenden Rollen in Ihrem Projekt, um auf Gemini-Funktionen zuzugreifen und API-Tokens für die Authentifizierung und Autorisierung von Anfragen zu generieren.

Bitten Sie Ihren Projekt-IAM-Administrator, Ihrem Nutzer- oder Dienstkonto im Namespace Ihres Projekts eine der zugehörigen Gemini-Rollen zuzuweisen. Informationen zu Gemini-Rollen finden Sie unter IAM-Berechtigungen vorbereiten.

Gemini API aktivieren

Sie müssen die Gemini API für Ihr Projekt aktivieren. Wenn die Gemini API aktiviert ist, können Sie den Dienststatus und den Endpunkt für die Gemini API aufrufen.

Clientbibliotheken installieren

Clientbibliotheken sind für die Programmiersprache Python verfügbar. Wir empfehlen, diese Clientbibliotheken für Aufrufe an die Gemini API zu verwenden, da sie den Zugriff auf APIs erleichtern.

Wenn Sie das OpenAI-kompatible Python SDK verwenden möchten, installieren Sie das OpenAI SDK und andere erforderliche Python-Bibliotheken:

pip install openai
pip install absl-py
pip install typing
pip install protobuf

Umgebungsvariablen festlegen

Nach der Installation der Clientbibliotheken können Sie über ein Python-Skript mit der API interagieren.

Wenn Sie in Ihrem Projekt ein Dienstkonto einrichten, um autorisierte API-Aufrufe programmatisch auszuführen, können Sie Umgebungsvariablen in einem Python-Skript definieren, um auf Werte wie die Dienstkontoschlüssel zuzugreifen.

So legen Sie erforderliche Umgebungsvariablen in einem Python-Skript fest:

Erstellen Sie ein Python-Skript.
Fügen Sie dem Python-Skript den folgenden Code hinzu:
Produktion
```
import os

os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"
```
Ersetzen Sie APPLICATION_DEFAULT_CREDENTIALS_FILENAME durch den Namen der JSON-Datei, die die von Ihnen im Projekt erstellten Dienstkontoschlüssel enthält, z. B. my-service-key.json.
Entwicklung
```
import os

os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "APPLICATION_DEFAULT_CREDENTIALS_FILENAME"
os.environ["GRPC_DEFAULT_SSL_ROOTS_FILE_PATH"] = "CERT_NAME"
```
Ersetzen Sie Folgendes:
- APPLICATION_DEFAULT_CREDENTIALS_FILENAME: Der Name der JSON-Datei, die die von Ihnen im Projekt erstellten Dienstkontoschlüssel enthält, z. B. my-service-key.json.
- CERT_NAME: der Name der Zertifikatsdatei der Zertifizierungsstelle (Certificate Authority, CA), z. B. org-1-trust-bundle-ca.cert. Weitere Informationen finden Sie unter CA-Zertifikatsdatei für das Vertrauensbündel in einer Entwicklungsumgebung generieren.
Speichern Sie das Python-Script unter einem Namen.
Führen Sie das Python-Skript aus, um die Umgebungsvariablen festzulegen:
```
python SCRIPT_NAME
```
Ersetzen Sie SCRIPT_NAME durch den Namen, den Sie Ihrem Python-Skript gegeben haben.

Authentifizierung einrichten

Bevor Sie die Gemini API verwenden können, müssen Sie Ihre Clientanmeldedaten authentifizieren und Kontozugriff auf Ihre Projektressourcen anfordern. Weitere Informationen finden Sie unter API-Anfragen authentifizieren.