API-Schlüssel anfordern

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

API-Schlüssel anfordern

API-Schlüssel mit einem curl-Befehl prüfen

Sie können einen curl-Befehl verwenden, um Ihre Einrichtung zu überprüfen. Sie können den API-Schlüssel entweder in der URL übergeben:

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent?key=${API_KEY}"

Oder im x-goog-api-key-Header:

API_KEY="YOUR_API_KEY"
curl -H 'Content-Type: application/json' \
     -H "x-goog-api-key: ${API_KEY}" \
     -d '{"contents":[
            {"role": "user",
              "parts":[{"text": "Give me five subcategories of jazz?"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-pro:generateContent"

API-Schlüssel sicher aufbewahren

Es ist wichtig, dass Sie Ihren Gemini API-Schlüssel sicher aufbewahren. Hier sind ein paar Dinge, die Sie beachten sollten: Beachten Sie Folgendes, wenn Sie Ihren Gemini API-Schlüssel verwenden:

  • Die Gemini API von Google AI verwendet für die Autorisierung API-Schlüssel. Wenn andere Zugriff erhalten mit Ihrem Gemini API-Schlüssel verknüpfen, können sie mit Ihrem Projektkontingent was zu einem Verlust von Kontingenten oder zusätzlichen Kosten führen kann (wenn die aktiviert). API-Schlüssel schützen außerdem den Zugriff auf abgestimmte Modelle und Dateien.

  • Wenn Sie in Google AI Studio auf API-Schlüssel abrufen klicken, wählen Sie aus, ob Sie können einen Gemini API-Schlüssel in einem neuen oder vorhandenen Google Cloud-Projekt bereitstellen. Die Liste der API-Schlüssel in Google AI Studio zeigt alle API-Schlüssel an, die AI Studio für die Verwendung mit der Google AI Gemini API (zusammen mit allen zugehörigen Google Cloud-Projekten).

    • Alle API-Schlüssel innerhalb des Google Cloud-Projekts können jedoch zum Aufrufen der Google AI Gemini API. Sie können alle Ihre die API-Schlüssel des Projekts in der APIs und Dienste > Bereich „Anmeldedaten“ in der Google Cloud Console.
  • Wird hinzugefügt Einschränkungen für API-Schlüssel können Sie die Oberfläche begrenzen, die für jeden API-Schlüssel verwendet werden kann. Standardmäßig enthält der Parameter Der von Google AI Studio generierte Gemini API-Schlüssel kann nur mit Google AI verwendet werden Gemini API (offiziell als „Generative Language API“ bezeichnet) oder generativelanguage.googleapis.com.

    • Wenn es in Ihrem Google Cloud-Projekt API-Schlüssel ohne API gibt Einschränkungen oder API-Schlüssel, die die generative Sprache auf die Zulassungsliste gesetzt haben API verwenden, können diese Schlüssel mit der Google AI Gemini API verwendet werden. Am besten jeden API-Schlüssel auf die APIs zu beschränken, die Sie damit aufrufen, .
    • Beachten Sie, dass selbst mit API-Schlüsseleinschränkungen ein böswilliger Akteur Ihre Website erhält, API-Schlüssel verwenden, können sie damit Aufrufe senden und das Kontingent Ihres Projekts für alle APIs auf der Zulassungsliste für diesen API-Schlüssel.
  • Sie sind dafür verantwortlich, Ihren Gemini API-Schlüssel zu schützen.

    • Setzen Sie Gemini API-Schlüssel NICHT in die Versionsverwaltung ein.
    • Risiko clientseitiger Anwendungen (Android, Swift, Web und Dart/Flutter) API-Schlüssel verfügbar machen, daher raten wir davon ab, die Google AI Client SDKs zu verwenden. in Produktions-Apps verwenden, um die Gemini API von Google AI direkt über Ihr mobile und Web-Apps. In den SDK-Kurzanleitungen erfahren Sie mehr sprachenspezifische Best Practices zur Sicherung Ihres API-Schlüssels.

Allgemeine Best Practices finden Sie Hilfeartikel.

Nächste Schritte

  • In den API-Kurzanleitungen finden Sie Best Practices. zum Sichern und Verwenden des API-Schlüssels.