Google Cloud API-Schlüssel abrufen

In dieser Anleitung erfahren Sie, wie Sie einen Google Cloud API-Schlüssel für die Verwendung von Gemini in Vertex AI erhalten. Dabei werden die folgenden Themen behandelt:

• Authentifizierungsoptionen:Ein Vergleich der Verwendung eines API-Schlüssels und von Standardanmeldedaten für Anwendungen.
• API-Schlüssel anfordern (neue Nutzer):So erhalten Sie schnell einen API-Schlüssel, wenn Sie kein Google Cloud -Konto haben.
• API-Schlüssel anfordern (bestehende Nutzer):Hier erfahren Sie, wie Sie einen Standard-API-Schlüssel generieren, wenn Sie bereits ein Google Cloud -Konto haben.

Authentifizierungsoptionen

Wenn Sie Gemini in Vertex AI verwenden möchten, müssen Sie sich authentifizieren. In der folgenden Tabelle werden die beiden primären Authentifizierungsmethoden verglichen.

Methode	Beschreibung	Vorteile	Nachteile	Optimal für
Google Cloud API-Schlüssel	Ein einfacher verschlüsselter String, der Zugriff auf Google Cloud APIs gewährt.	Einfache und schnelle Einrichtung.	Weniger sicher; erfordert sorgfältige Verwaltung, um Offenlegung zu verhindern.	Kurzanleitungen, Prototyping und erste Entwicklung.
Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC)	Eine Strategie, mit der Anmeldedaten automatisch basierend auf der Anwendungsumgebung gefunden werden.	Sicherer, da Anmeldedaten nicht fest codiert sind. Verwaltet die Rotation von Anmeldedaten automatisch.	Erfordert mehr Ersteinrichtung und IAM-Kenntnisse.	Produktions- und sicherheitssensible Umgebungen.

Wir empfehlen, für erste Tests einen API-Schlüssel und für die Produktion Standardanmeldedaten für Anwendungen zu verwenden. Auf dieser Seite erfahren Sie, wie Sie einen Google Cloud API-Schlüssel erhalten, je nachdem, ob Sie bereits ein Google Cloud -Konto haben.

Wählen Sie aus, ob Sie ein Google Cloud -Konto haben:

Nein, ich habe kein Konto Ja, ich habe ein Konto

---

Google Cloud API-Schlüssel erstellen

Wenn Sie bereits ein Google Cloud -Konto haben, folgen Sie der Anleitung unten, um einen Standard- Google Cloud API-Schlüssel zu erhalten.

Hinweise

Konzepte

• Dienstkonto:Eine spezielle Art von Google-Konto, das einen nicht menschlichen Nutzer repräsentiert. Es muss authentifiziert und autorisiert werden, um Zugriff auf Daten in Google APIs zu erhalten.
• API-Schlüssel:Ein einfacher verschlüsselter String, der ein Google-Projekt zu Kontingent-, Abrechnungs- und Monitoringzwecken identifiziert.
• IAM (Identity and Access Management):Definiert, wer (Identität) welchen Zugriff (Rolle) auf welche Ressource hat.

Vorbereitung

Projekt auswählen, Abrechnung aktivieren und Vertex AI API aktivieren

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.

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.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

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.

Enable the API

Schritt 1: Erstellung von API-Schlüsseln für Dienstkonten aktivieren

Wichtig:Damit Sie diesen Schritt ausführen können, muss für Ihr Nutzerkonto die Rolle Administrator für Unternehmensrichtlinien für Ihre Organisation aktiviert sein. Wenn Sie diese Rolle nicht haben oder diese Konfiguration nicht vornehmen können, verwenden Sie stattdessen Standardanmeldedaten für Anwendungen.

1. Öffnen Sie IAM & Verwaltung > Organisationsrichtlinien.
2. Filtern Sie in der Liste der Richtlinien nach Richtlinien mit dem Namen iam.managed.disableServiceAccountApiKeyCreation.
3. Klicken Sie auf Aktionen > Richtlinie bearbeiten.
4. Wählen Sie unter Richtlinienquelle die Option Richtlinie der übergeordneten Ressource überschreiben aus und klicken Sie dann auf Regel hinzufügen.
5. Wählen Sie unter Erzwingung die Option Aus aus.
6. Klicken Sie auf Fertig.
7. Klicken Sie auf Richtlinie festlegen. Klicken Sie im angezeigten Dialogfeld noch einmal auf Richtlinie festlegen.

Schritt 2: Neues Dienstkonto erstellen

1. Öffnen Sie IAM & Verwaltung > Dienstkonten.
2. Klicken Sie auf Dienstkonto erstellen.
3. Konfigurieren Sie das Dienstkonto so:
   • Name des Dienstkontos: vertex-ai-runner
   • Dienstkonto-ID: vertexairunner
4. Klicken Sie auf Erstellen und fortfahren.
5. Klicken Sie unter Berechtigungen auf Rolle auswählen und wählen Sie im Menü Vertex AI Platform Express-Nutzer aus.
6. Klicken Sie auf Weiter.
7. Klicken Sie auf Fertig.

Schritt 3: API-Schlüssel erstellen

1. Öffnen Sie APIs & Dienste > Anmeldedaten.
2. Klicken Sie auf Anmeldedaten erstellen > API-Schlüssel.
3. Konfigurieren Sie den API-Schlüssel so:
   • Name: vertexaiapikey
   • API-Aufrufe über ein Dienstkonto authentifizieren: Ausgewählt.
4. Klicken Sie auf Dienstkonto auswählen.
5. Wählen Sie das Dienstkonto aus, das Sie im vorherigen Schritt erstellt haben, und klicken Sie auf Auswählen.
6. Klicken Sie auf Erstellen.

Erste API-Anfrage stellen

Nachdem Sie einen API-Schlüssel erhalten haben, erfahren Sie in der API-Kurzanleitung, wie Sie Ihren API-Schlüssel verwenden, um Ihre erste Anfrage zu stellen.

Optional: API-Schlüssel lokal einrichten

Für erste Tests können Sie einen API-Schlüssel fest codieren. Das ist jedoch nicht sicher und sollte nur vorübergehend erfolgen. In der folgenden Anleitung wird beschrieben, wie Sie Ihren API-Schlüssel lokal als Umgebungsvariable einrichten.

API-Schlüssel als Umgebungsvariable festlegen

Linux/macOS

1. Führen Sie den folgenden Befehl aus, um zu sehen, welche Befehlszeilen-Shell Sie verwenden:

   echo $SHELL

   Die Ausgabe sieht etwa so aus:

   /bin/bash

2. Fügen Sie je nach Shell eine Shell-Exportvariable für Ihren API-Schlüssel hinzu:

   • Wenn Ihre Shell /bin/bash ist:

     1. Rufen Sie .bashrc auf:

        touch ~/.bashrc
        open ~/.bashrc

     2. Fügen Sie .bashrc die folgende Zeile hinzu und ersetzen Sie <var>YOUR_API_KEY</var> durch Ihren Schlüssel:

        export GEMINI_API_KEY=<var>YOUR_API_KEY</var>

     3. Speichern Sie die Datei und führen Sie dann Folgendes aus, um die Änderungen zu übernehmen:

        source ~/.bashrc

   • Wenn Ihre Shell /bin/zsh ist:

     1. Rufen Sie .zshrc auf:

        touch ~/.zshrc
        open ~/.zshrc

     2. Fügen Sie .zshrc die folgende Zeile hinzu und ersetzen Sie <var>YOUR_API_KEY</var> durch Ihren Schlüssel:

        export GEMINI_API_KEY=<var>YOUR_API_KEY</var>

     3. Speichern Sie die Datei und führen Sie dann Folgendes aus, um die Änderungen zu übernehmen:

        source ~/.zshrc

Windows

1. Öffnen Sie das Startmenü und suchen Sie nach „Umgebungsvariablen“.
2. Klicken Sie auf „Systemumgebungsvariablen bearbeiten“.
3. Klicken Sie im Fenster „Systemeigenschaften“ auf die Schaltfläche „Umgebungsvariablen“.
4. Klicken Sie im Bereich „Nutzervariablen“ auf „Neu…“.
5. Geben Sie unter „Variablenname“ GEMINI_API_KEY ein.
6. Fügen Sie Ihren API-Schlüssel in das Feld „Variablenwert“ ein.
7. Klicken Sie in allen geöffneten Fenstern auf „OK“, um die Änderungen zu übernehmen.
8. Starten Sie alle geöffneten Terminal- oder Eingabeaufforderungsfenster neu, damit die Änderungen wirksam werden.

---

ACHTUNG:Es ist wichtig, Ihren API-Schlüssel sicher aufzubewahren. Beachten Sie bei der Verwendung Ihres API-Schlüssels Folgendes:

• Für Produktionsanwendungen empfiehlt Google Cloud die Verwendung von Standardanmeldedaten für Anwendungen als sicherere Authentifizierungsmethode.
• Vertex AI verwendet API-Schlüssel zur Autorisierung. Wenn andere Zugriff auf Ihren API-Schlüssel erhalten, können sie Aufrufe mit dem Kontingent Ihres Projekts ausführen. Dies kann dazu führen, dass Kontingent verloren geht oder zusätzliche Gebühren anfallen. Außerdem können sie auf Ihre abgestimmten Modelle und Dateien zugreifen.
• Durch das Hinzufügen von Einschränkungen für API-Schlüssel kann die über jeden API-Schlüssel nutzbare Oberfläche eingeschränkt werden.
• Sie sind dafür verantwortlich, dass Ihr API-Schlüssel sicher aufbewahrt wird.
  • Checken Sie API-Schlüssel nicht in die Versionsverwaltung ein.
  • Bei clientseitigen Anwendungen (Android, Swift, Web und Dart/Flutter) besteht das Risiko, dass API-Schlüssel offengelegt werden. Wir empfehlen nicht, die Google AI Client-SDKs zu verwenden, um die API direkt über Ihre mobilen Apps und Web-Apps aufzurufen.

Allgemeine Best Practices finden Sie in diesem Hilfeartikel zur Sicherheit von API-Schlüsseln.