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

Ein Gemini API key ist eine Anmeldedaten, die Ihre Aufrufe der Gemini-Modelle von Google authentifiziert: Jede Anfrage enthält den Schlüssel im Header Authorization, und die Nutzung wird gemessen und pro Token abgerechnet. Es gibt zwei Wege zu einem funktionierenden Schlüssel: Google AI Studio (offiziell), das einen ausschließlich für Gemini bestimmten Schlüssel ausstellt, oder Kunavo, wo ein einziger OpenAI-kompatibler Schlüssel Gemini, Claude, GPT sowie Bild-, Video- und Audiomodelle erreicht — ohne Google-Cloud-Projekt. Dieser Leitfaden zeigt, wie Sie über beide Wege einen Schlüssel erhalten und den ersten Aufruf durchführen.

Option 1 — Google AI Studio (offiziell)

Dies ist der richtige Weg, wenn Gemini das einzige Modell ist, das Sie aufrufen werden.

1. Melden Sie sich mit einem Google-Konto bei aistudio.google.com an.
2. Öffnen Sie Get API key → Create API key. Der Schlüssel hat das Format AIza....
3. Die kostenlose Stufe ist begrenzt und für Prototypen geeignet. Für Produktionsvolumen muss der Schlüssel mit einem Google-Cloud-Projekt und einem aktivierten Abrechnungskonto verknüpft werden.

Wenn Sie außerdem Claude, Bild- oder Videomodelle verwenden, müssen Sie bei diesem Weg für jeden Anbieter einen separaten Schlüssel, ein separates SDK und eine separate Rechnung verwalten.

Option 2 — Kunavo (für den Produktionseinsatz empfohlen)

Kunavo stellt Gemini hinter eine OpenAI-kompatible API. Mit einem einzigen Schlüssel sk-kn- rufen Sie Gemini und alle anderen Modelle auf, mit einem einzigen über Stripe abgerechneten Guthabenkonto und ohne irgendein Google-Cloud-Projekt. Gemini kostet etwa 70% weniger als Googles offizieller Listenpreis — Flash kostet beispielsweise $0.09 pro 1 Million Eingabetoken und $0.75 pro 1 Million Ausgabetoken. Dies ist Pay-as-you-go ab einer Mindestaufladung von $10, und das Guthaben verfällt nie.

1. Registrieren Sie sich auf kunavo.com.
2. Laden Sie $10 auf — Pay-as-you-go, das Guthaben verfällt nie.
3. Erstellen Sie einen Schlüssel unter /app/keys. Der Schlüssel beginnt mit sk-kn- und wird nur einmal angezeigt; speichern Sie ihn in einer Umgebungsvariablen.
4. Rufen Sie das Modell auf, indem Sie das OpenAI-SDK auf https://api.kunavo.com/v1 ausrichten und einen Gemini-Slug verwenden.

Schnellstart

Verwenden Sie weiterhin das offizielle OpenAI-SDK. Ändern Sie 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",  # dòng duy nhất thay đổi
)

resp = client.chat.completions.create(
    model="gemini-2-5-flash",
    messages=[{"role": "user", "content": "Giải thích RAG trong hai câu."}],
)
print(resp.choices[0].message.content)

Schlüsselsicherheit

• Geben Sie den Schlüssel niemals auf der Clientseite preis. Browser- und Mobile-Bundles sind öffentlich — leiten Sie Anfragen immer über Ihren eigenen Server weiter. Speichern Sie den Schlüssel in Umgebungsvariablen, außerhalb versionierten Codes.
• Verwenden Sie einen Schlüssel pro Projekt oder Umgebung, damit ein einzelnes Leck widerrufen werden kann, ohne die übrigen Umgebungen lahmzulegen.
• Rotieren Sie die Schlüssel regelmäßig. Kunavo erlaubt mehrere gleichzeitig aktive Schlüssel, sodass die Rotation nahtlos und nicht mit einer abrupten Unterbrechung erfolgt.
• Legen Sie im Dashboard Ausgabenlimits pro Schlüssel fest und überwachen Sie /app/usage, um unerwarteten Datenverkehr nach Schlüssel aufgeschlüsselt zu erkennen.

Häufig gestellte Fragen