Google Cloud API-Schlüssel abrufen

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 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:


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. Alternativ können Sie Standardanmeldedaten für Anwendungen anstelle eines API-Schlüssels verwenden.

Hinweise

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

  1. Sign in to your Google Account.

    If you don't already have one, sign up for a new account.

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

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Vertex AI API.

    Enable the API

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

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Vertex AI API.

    Enable the API

Erstellen von Dienstkonto-API-Schlüsseln aktivieren

  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.

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.

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. Dies sollte jedoch nur vorübergehend erfolgen, da es nicht sicher ist. Im Rest dieses Abschnitts wird beschrieben, wie Sie Ihren API-Schlüssel lokal als Umgebungsvariable für verschiedene Betriebssysteme einrichten.

Zum Maximieren der Anleitung klicken

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 eine Shell-Exportvariable für Ihren API-Schlüssel hinzu. Gehen Sie dazu so vor:

    • Wenn die Ausgabe des vorherigen Schritts /bin/bash ist:

      1. Rufen Sie .bashrc auf:

        touch ~/.bashrc
                open ~/.bashrc
      2. Fügen Sie folgende Zeile zu .bashrc hinzu:

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

        source ~/.bashrc
    • Wenn die Ausgabe des vorherigen Schritts /bin/zsh ist:

      1. Rufen Sie .zshrc auf:

        touch ~/.zshrc
                open ~/.zshrc
      2. Fügen Sie folgende Zeile zu .zshrc hinzu:

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

        source ~/.zshrc

Windows

  1. Suchen Sie in den Systemeinstellungen nach „Umgebungsvariablen“.
  2. Bearbeiten Sie entweder „Nutzervariablen“ (für den aktuellen Nutzer) oder „Systemvariablen“ (für alle Nutzer – mit Vorsicht verwenden).
  3. Variable erstellen und export GEMINI_API_KEY=YOUR_API_KEY hinzufügen
  4. Änderungen anwenden