Gemini API-Schlüssel anfordern

Zur Verwendung der Gemini API benötigen Sie einen API-Schlüssel. Sie können einen Schlüssel mit wenigen Klicks in Google AI Studio erstellen.

Gemini API-Schlüssel in Google AI Studio abrufen

API-Schlüssel einrichten

Für die ersten Tests können Sie einen API-Schlüssel hartcodieren. Dies sollte jedoch nur vorübergehend sein, da es nicht sicher ist. Im Rest dieses Abschnitts wird beschrieben, wie Sie Ihren API-Schlüssel lokal als Umgebungsvariable mit verschiedenen Betriebssystemen einrichten.

Linux/macOS – Bash

Bash ist eine gängige Linux- und macOS-Terminalkonfiguration. Mit dem folgenden Befehl können Sie prüfen, ob eine Konfigurationsdatei vorhanden ist:

~/.bashrc

Wenn die Antwort „Datei oder Verzeichnis nicht gefunden“ lautet, müssen Sie diese Datei erstellen und mit den folgenden Befehlen oder mit zsh öffnen:

touch ~/.bashrc
open ~/.bashrc

Als Nächstes müssen Sie Ihren API-Schlüssel mit dem folgenden Exportbefehl festlegen:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Übernehmen Sie die Änderungen mit dem folgenden Befehl:

source ~/.bashrc

macOS – Zsh

Zsh ist eine gängige Linux- und macOS-Terminalkonfiguration. Mit dem folgenden Befehl können Sie prüfen, ob eine Konfigurationsdatei vorhanden ist:

~/.zshrc

Wenn die Antwort „Datei oder Verzeichnis nicht gefunden“ lautet, müssen Sie diese Datei erstellen und mit den folgenden Befehlen oder mit bash öffnen:

touch ~/.zshrc
open ~/.zshrc

Als Nächstes müssen Sie Ihren API-Schlüssel mit dem folgenden Exportbefehl festlegen:

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

Übernehmen Sie die Änderungen mit dem folgenden Befehl:

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_key_here hinzufügen
  4. Änderungen anwenden

Erste Gemini API-Anfrage senden

Sie können die Einrichtung mit einem curl-Befehl prüfen:

  curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=${GEMINI_API_KEY}" \
    -H 'Content-Type: application/json' \
    -X POST \
    -d '{
      "contents": [{
        "parts":[{"text": "Write a story about a magic backpack."}]
        }]
       }'

API-Schlüssel schützen

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

  • Die Google AI Gemini API verwendet API-Schlüssel für die Autorisierung. Wenn andere Personen Zugriff auf Ihren Gemini API-Schlüssel erhalten, können sie Aufrufe mit dem Kontingent Ihres Projekts ausführen. Dies kann zu einem Verlust des Kontingents oder zu zusätzlichen Kosten für abrechenbare Projekte führen. Außerdem können sie auf abgestimmte Modelle und Dateien zugreifen.

  • Durch das Hinzufügen von API-Schlüsseleinschränkungen können Sie die Oberfläche einschränken, die über jeden API-Schlüssel verwendet werden kann.

  • Sie sind dafür verantwortlich, Ihren Gemini API-Schlüssel sicher aufzubewahren.

    • Gemini API-Schlüssel dürfen NICHT in die Versionsverwaltung eingecheckt werden.
    • 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 in Produktions-Apps zu verwenden, um die Google AI Gemini API direkt über Ihre mobilen und Web-Apps aufzurufen.

Allgemeine Best Practices finden Sie auch in diesem Hilfeartikel.