API-Schlüssel anfordern

Wenn Sie die Gemini API verwenden möchten, benötigen Sie einen API-Schlüssel. In Google AI Studio können Sie mit einem Klick einen Schlüssel erstellen.

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

Sie können die Einrichtung mit einem curl-Befehl ü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 Ihr Gemini API-Schlüssel sicher ist. Bei der Verwendung Ihres Gemini-API-Schlüssels sollten Sie Folgendes beachten:

Die Google AI Gemini API verwendet API-Schlüssel für die Autorisierung. Wenn andere Zugriff auf Ihren Gemini API-Schlüssel erhalten, können sie Aufrufe über das Kontingent Ihres Projekts tätigen. Das kann zum Verlust von Kontingenten oder zu zusätzlichen Abrechnungsgebühren führen (falls die Abrechnung aktiviert ist). API-Schlüssel schützen auch den Zugriff auf abgestimmte Modelle und Dateien.
Wenn Sie in Google AI Studio auf API-Schlüssel abrufen klicken, wählen Sie aus, ob ein Gemini API-Schlüssel in einem neuen oder vorhandenen Google Cloud-Projekt bereitgestellt werden soll. Die Liste der API-Schlüssel in Google AI Studio enthält alle API-Schlüssel, die AI Studio für die Verwendung mit der Google AI Gemini API bereitgestellt hat (einschließlich aller zugehörigen Google Cloud-Projekte).
- Allerdings können alle API-Schlüssel innerhalb des Google Cloud-Projekts zum Aufrufen der Google AI Gemini API verwendet werden. Sie können alle API-Schlüssel Ihres Projekts in der Google Cloud Console im Bereich APIs und Dienste > Anmeldedaten ansehen und verwalten.
Wenn Sie Einschränkungen für API-Schlüssel festlegen, lässt sich die mit jedem API-Schlüssel nutzbare Oberfläche einschränken. Standardmäßig kann der von Google AI Studio generierte Gemini API-Schlüssel nur mit der Google AI Gemini API (offiziell als „Generative Language API“ oder generativelanguage.googleapis.com bezeichnet) verwendet werden.
- Wenn in Ihrem Google Cloud-Projekt API-Schlüssel ohne API-Einschränkungen vorhanden sind oder API-Schlüssel auf der Zulassungsliste für die Generative Language API stehen, können diese Schlüssel mit der Google AI Gemini API verwendet werden. Es empfiehlt sich, einen API-Schlüssel auf die APIs zu beschränken, die Sie mit diesem Schlüssel aufrufen.
- Hinweis: Auch bei Einschränkungen für API-Schlüssel können böswillige Akteure damit Aufrufe ausführen und dabei das Kontingent Ihres Projekts für alle APIs auf der Zulassungsliste für diesen API-Schlüssel nutzen.
Sie sind für die Sicherheit Ihres Gemini API-Schlüssels verantwortlich.
- Geben Sie Gemini API-Schlüssel NICHT in die Versionsverwaltung ein.
- Bei clientseitigen Anwendungen (Android, Swift, Web und Dart/Flutter) besteht die Gefahr, dass API-Schlüssel offengelegt werden. Daher raten wir davon ab, die Google AI-Client-SDKs in Produktionsanwendungen zu verwenden, um die Google AI Gemini API direkt über Ihre mobilen Apps und Webanwendungen aufzurufen. In den SDK-Kurzanleitungen finden Sie sprachspezifische Best Practices zum Sichern Ihres API-Schlüssels.

Einige allgemeine Best Practices finden Sie auch in diesem Hilfeartikel.

Nächste Schritte

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