Google Gemini API: API-Key erstellen & nutzen

Du willst Gemini in einer eigenen Anwendung, Automatisierung oder einem serverseitigen Workflow nutzen?

Dann brauchst du einen Google Gemini API-Key. Die Einrichtung beginnt in Google AI Studio. Entscheidend ist danach, den Key nicht wie einen Kopiercode zu behandeln, sondern wie ein Passwort.

Diese Anleitung zeigt den aktuellen Ablauf für neue Auth-Keys, den sicheren Umgang mit bestehenden Standard-Keys und einen minimalen serverseitigen Test.

1. Google-Konto und Projekt vorbereiten

Für die Gemini API brauchst du ein Google-Konto. Nach der Zustimmung zu den Nutzungsbedingungen erstellt Google AI Studio für neue Nutzer automatisch ein Standardprojekt und einen API-Key.

Wenn du bereits Google Cloud verwendest, tauchen nicht automatisch alle Projekte in AI Studio auf. Öffne im Dashboard die Projektübersicht, importiere das gewünschte Projekt und erstelle den Key danach auf der Seite „API-Schlüssel“.

Googles Anleitung zu API-Keys beschreibt beide Fälle und die erforderlichen Berechtigungen für importierte Projekte.

2. Einen Gemini API-Key in AI Studio erstellen

Öffne Google AI Studio. Wähle im Dashboard „API-Schlüssel“ und anschließend „API-Schlüssel erstellen“.

Die Übersicht zeigt das Projekt „Test“ ohne API-Schlüssel.

Im Dialog „Neuen Schlüssel erstellen“ vergibst du einen beschreibenden Namen und wählst ein bereits importiertes Projekt aus. Erstelle nur dann ein neues Projekt, wenn es wirklich von deinen bestehenden Umgebungen getrennt sein soll.

Prüfe Namen und Projekt und klicke dann auf „Schlüssel erstellen“. Nach der erfolgreichen Erstellung kopierst du den neuen API-Key und hinterlegst ihn ausschließlich serverseitig.

3. Den Key sicher im Server hinterlegen

Nutze den Key nur auf dem Server. Für einen lokalen Test kannst du ihn in der aktuellen Terminal-Sitzung als Umgebungsvariable setzen.

export GEMINI_API_KEY="DEIN_API_KEY"

Für eine Website oder App gehört der Aufruf in ein Backend. Der Browser ruft dann ausschließlich deinen eigenen Endpunkt auf. In einer Produktionsumgebung legst du den Key in der Secret-Verwaltung des jeweiligen Hosters ab.

4. Bestehende Keys absichern oder durch Auth-Key ersetzen

Die offizielle Google-Dokumentation nennt September 2026 als Zeitpunkt, ab dem Gemini API-Anfragen mit Standard-Keys abgelehnt werden. Neue Keys aus AI Studio sind bereits Auth-Keys.

Bei älteren Projekten oder unklarer Key-Herkunft ist der sichere Migrationsweg einfach. Erstelle in AI Studio einen neuen Auth-Key, aktualisiere die Umgebungsvariable und die Konfiguration für die Veröffentlichung, teste den Aufruf und widerrufe den alten Key erst nach einem erfolgreichen Test.

Ein älterer, nur für Gemini verwendeter Key mit der Kennzeichnung „Unrestricted“ lässt sich direkt in AI Studio einschränken. Fahre über die Kennzeichnung, wähle „Add restrictions“, dann „Restrict to Gemini API only“ und bestätige mit „Restrict key“. Das begrenzt den Einsatzbereich dieses Keys, ändert aber nicht seinen Typ und ersetzt keine Auth-Key-Migration.

Für IP-Adressen, Websites oder Apps öffnest du die Schlüssel-Details in der Google Cloud Console. Teile einen Gemini-Key nicht mit anderen Google APIs. Erstelle für diese einen separaten Schlüssel, weil weitere API-Beschränkungen die Gemini-Nutzung dieses Keys unterbrechen können.

5. Kosten, Limits und Abrechnung prüfen

Neue Konten beginnen im kostenlosen Tarif. Die verfügbaren Modelle, Rate Limits und Preise ändern sich je nach Modell und Tarif. Die verbindlichen Werte stehen auf der Google-Preisseite. Einen modellübergreifenden Vergleich findest du im LLM-Preisindex.

Für höhere Limits oder kostenpflichtige Modelle verknüpfst du ein Abrechnungskonto. Google weist darauf hin, dass der kostenpflichtige Tarif je nach Konto eine Mindest-Vorauszahlung von 5 $ erfordern kann. Prüfe die Bedingungen auf dem finalen Google-Bildschirm, bevor du eine Abrechnung einrichtest.

Deinen Verbrauch kontrollierst du in AI Studio über Dashboard > Nutzung. Lege zusätzlich Abrechnungsbenachrichtigungen in Google Cloud an, wenn ein Projekt produktiv läuft.

6. Die API serverseitig testen

Der folgende Befehl folgt der aktuellen REST-Referenz. Er verwendet die Umgebungsvariable aus dem vorherigen Schritt und das aktive Modell gemini-3.8-flash. Ersetze den Modellnamen nur durch ein Modell, das für dein Projekt und deinen Tarif verfügbar ist.

curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: $GEMINI_API_KEY" \
  -X POST \
  -d '{
    "model": "gemini-3.8-flash",
    "input": "Erkläre maschinelles Lernen in einem Satz."
  }'

Eine erfolgreiche Antwort bestätigt, dass der Key, das Projekt und der gewählte Modellzugang zusammenpassen. Erscheint der Button zum Erstellen eines Keys nicht, fehlen in einem importierten Projekt meist IAM-Berechtigungen. Bei einem blockierten alten Key erstellst du einen neuen Auth-Key und widerrufst den alten Key erst nach einem erfolgreichen Test.