Standardanmeldedaten für Anwendungen konfigurieren

Wenn Sie Gemini in Vertex AI verwenden möchten, müssen Sie sich mit einem Google Cloud API-Schlüssel oder mit Standardanmeldedaten für Anwendungen authentifizieren. Wir empfehlen, für Tests einen API-Schlüssel und für die Produktion die standardmäßigen Anmeldedaten der Anwendung zu verwenden. Auf dieser Seite erfahren Sie, wie Sie Standardanmeldedaten für Anwendungen konfigurieren.

Hinweis

Projekt auswählen, Abrechnung aktivieren, Vertex AI API aktivieren, gcloud CLI installieren

Melden Sie sich in Ihrem Google-Konto an.

Wenn Sie noch kein Konto haben, melden Sie sich hier für ein neues Konto an.

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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

Installieren Sie die Google Cloud CLI.

Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren:

gcloud init

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 role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

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

Installieren Sie die Google Cloud CLI.

Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren:

gcloud init

Lokale Anmeldedaten zur Authentifizierung erstellen

Wenn Sie eine lokale Shell verwenden, erstellen Sie lokale Anmeldedaten zur Authentifizierung für Ihr Nutzerkonto:

gcloud auth application-default login

Wenn Sie Cloud Shell verwenden, müssen Sie das nicht tun.

Wenn ein Authentifizierungsfehler zurückgegeben wird und Sie einen externen Identitätsanbieter (IdP) verwenden, prüfen Sie, ob Sie sich mit Ihrer föderierten Identität in der gcloud CLI angemeldet haben.

Hinweis: Sie können Standardanmeldedaten für Anwendungen in verschiedenen Umgebungen einrichten, z. B. für eine Ressource mit einem angehängten Dienstkonto, in Containerumgebungen, lokal oder bei anderen Cloud-Anbietern oder in einer Google Cloud-basierten Entwicklungsumgebung. Weitere Informationen finden Sie unter Standardanmeldedaten für Anwendungen einrichten.

Erste API-Anfrage stellen

Nachdem Sie die Standardanmeldedaten für Anwendungen konfiguriert haben, erfahren Sie in der API-Kurzanleitung, wie Sie Ihre erste Anfrage stellen.