Gemini-API-Schlüssel — so erhalten und mit dem OpenAI SDK verwenden

Ein Gemini-API-Schlüssel authentifiziert deine Aufrufe der Gemini-Modelle von Google: Jede Anfrage enthält den Schlüssel im Header Authorization, und die Plattform misst und berechnet die Nutzung darüber. Es gibt zwei Möglichkeiten, einen Gemini-API-Schlüssel zu erhalten — direkt über Google AI Studio (der offizielle Weg) oder über Kunavo: ein OpenAI-kompatibler Schlüssel, der Gemini sowie Claude, GPT und Bild- und Videomodelle erreicht, ohne Google-Cloud-Projekt.

Option 1 — Google AI Studio (offiziell)

Wenn Gemini das einzige Modell ist, das du jemals aufrufen wirst, beziehe den Schlüssel direkt von Google:

1. Öffne aistudio.google.com und melde dich mit einem Google-Konto an.
2. Gehe zu Get API key → Create API key. Die Schlüssel beginnen mit AIza… und werden nur einmal angezeigt.
3. Die kostenlose Stufe ist ratenbegrenzt und eignet sich für Prototyping. Für die Produktion verknüpfst du den Schlüssel mit einem Google-Cloud-Abrechnungskonto.

Das ist der richtige Weg, solange du nur Gemini benötigst. Sobald du auch Claude, GPT oder Bild- und Videomodelle verwendest, verwaltest du pro Anbieter einen Schlüssel, ein SDK und eine Rechnung.

Option 2 — Kunavo (für die Produktion empfohlen)

Kunavo stellt Gemini hinter eine OpenAI-kompatible API. Ein einziger Schlüssel sk-kn- erreicht alle Modelle über denselben Endpunkt — kein Google-Cloud-Projekt, Gemini etwa 70 % unter Googles Listenpreis ($0.09 / $0.75 pro 1 Mio. Token), ein Stripe-Guthaben, Pay-as-you-go ab einer Aufladung von $10. Das Guthaben deckt Gemini, Claude, GPT, Bild und Video gemeinsam ab und verfällt nie.

1. Registriere dich. Erstelle ein Kunavo-Konto unter kunavo.com.
2. Lade $10 auf. Pay-as-you-go ab einer Mindestaufladung von $10; das Guthaben verfällt nie.
3. Erstelle den Schlüssel. Erzeuge einen Schlüssel unter /app/keys. Er beginnt mit sk-kn- und wird nur einmal angezeigt — speichere ihn in einer Umgebungsvariablen.
4. Rufe die API auf. Verweise das OpenAI-SDK auf https://api.kunavo.com/v1 und rufe einen Gemini-Slug auf.

Schnellstart

Behalte das offizielle OpenAI-SDK bei. Du änderst nur base_url und den Modellnamen — sonst nichts.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # la seule ligne qui change
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Résume l'intrigue de Dune en deux phrases."}],
)
print(resp.choices[0].message.content)

Dasselbe Muster gilt für Node.js und curl; die Preise pro Modell und ausführliche Beispiele findest du im Leitfaden zu den Preisen der Gemini API.

Den Schlüssel sicher aufbewahren

• Umgebungsvariablen statt Quellcode. Commite den Schlüssel niemals ins Repository, sondern lies ihn aus einer Umgebungsvariablen. Lege ihn niemals in einem Browser- oder Mobile-Bundle offen — leite Aufrufe immer über deinen eigenen Server.
• Ein Schlüssel pro Projekt oder Umgebung. Einen durchgesickerten Schlüssel kannst du widerrufen, ohne etwas anderes zu beschädigen.
• Regelmäßig rotieren. Kunavo erlaubt mehrere aktive Schlüssel. Dadurch wird die Rotation zu einer sauberen Überschneidung statt zu einem abrupten Ausfall.
• Ausgabenlimits pro Schlüssel. Lege im Dashboard Limits pro Schlüssel fest und überwache unerwarteten Datenverkehr pro Schlüssel unter /app/usage.

Häufig gestellte Fragen