Dokumentation

In 2 Minuten startklar.

Die Geraikita-AI-API unterstützt zwei Formate zugleich: OpenAI Chat Completions und Anthropic Messages. Nutze das OpenAI SDK, Anthropic SDK, Claude Code CLI, Cline und andere Tools — einfach Base-URL und API-Key ändern.

Base-URL (OpenAI)https://ai.geraikita.com/v1

Base-URL (Anthropic)https://ai.geraikita.com

AuthentifizierungBearer gk-... (oder x-api-key: gk-...)

Wichtig — schreibe /v1 nicht doppelt.

OpenAIhttps://ai.geraikita.com/v1OpenAI-Clients hängen /chat/completions an die Base-URL an — die Base endet also mit /v1.

Anthropic / Claude Code CLIhttps://ai.geraikita.comAnthropic-Clients (Claude Code CLI, Anthropic SDK) hängen /v1/messages selbst an — die Base kommt also ohne /v1.

Falsch gemacht wird der Pfad zu /v1/v1/messages → Fehler 400.

Der Free Tier (Bansos) nutzt einen SEPARATEN KEY — nicht deinen bezahlten Key.

Ein Bansos-Key muss zuerst abgeholt werden auf der Bansos-Seite (Login + Telegram-Verifizierung, gratis, einmal pro Konto). Ein bezahlter gk--Key aus dem Dashboard funktioniert nicht auf dem Bansos-Endpunkt, und umgekehrt — bei Verwechslung kommt 401 unauthorized zurück.

Die Bansos-Base-URL ist ebenfalls anders als die bezahlte oben:

Bansos-Base-URLhttps://ai.geraikita.com/v1/claude

OpenAIhttps://ai.geraikita.com/v1/claude/chat/completions

Anthropic / Claude Code CLIANTHROPIC_BASE_URL=https://ai.geraikita.com/v1/claudeDas SDK hängt /v1/messages selbst an → https://ai.geraikita.com/v1/claude/v1/messages.

Modell-DiscoveryGET https://ai.geraikita.com/v1/claude/models

Alles andere ist exakt gleich wie beim bezahlten Endpunkt.

Authentifizierung

Jeder Request trägt deinen gk--API-Key im Header Authorization: Bearer gk-.... Keys werden im Dashboard erstellt und nur einmal bei der Erstellung angezeigt — bewahre sie sicher auf. Du kannst jeden Key auf bestimmte Modelle beschränken (Allowlist).

Erster Request

from openai import OpenAI

client = OpenAI(
    base_url="https://ai.geraikita.com/v1",
    api_key="gk-xxxxxxxx",
)
resp = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Halo!"}],
)
print(resp.choices[0].message.content)

Claude Code CLI

Claude Code nutzt das Anthropic-Format. Setze die Base-URL auf die Root (https://ai.geraikita.com — ohne /v1) und führe dann claude aus. Nutze die Modelle claude-sonnet-5 / claude-opus-5 / claude-haiku-4-5.

# Base-URL = ROOT ohne /v1 (Claude Code hängt /v1/messages selbst an)
export ANTHROPIC_BASE_URL="https://ai.geraikita.com"
export ANTHROPIC_AUTH_TOKEN="gk-xxxxxxxx"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-sonnet-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"

claude

Cline & weitere Tools

Cline / Roo (OpenAI Compatible): Provider OpenAI Compatible, Base-URL https://ai.geraikita.com/v1, API-Key gk-..., Modell-ID claude-sonnet-5.

Cline (Anthropic): Provider Anthropic, Base-URL https://ai.geraikita.com, API-Key gk-....

Erkennt dein Tool Modelle automatisch? Der Endpunkt GET https://ai.geraikita.com/v1/models ist verfügbar. Gibt es ein Feld „Gateway Base URL“, das automatisch /v1/models anhängt, trage dort https://ai.geraikita.com (Root) ein, damit nicht /v1/v1/models daraus wird.

GeraiPoints

1 GP = Rp1. Du wirst pro Token nach dem realen Verbrauch jedes Requests abgerechnet — keine feste Gebühr pro Request, nur ein kleiner Mindestbetrag pro Request je Modell (Floor). Lade GeraiPoints im Dashboard auf; dein Guthaben verfällt nie und gilt für jedes Modell. Keine Abos oder Monatskontingente.

Modellliste

Die model-Werte, die du senden kannst. Die Tarife der einzelnen Modelle findest du auf der Preisseite.

Schreibe den Modellnamen GENAU wie gelistet — ohne Präfix. Sende claude-sonnet-5, nicht gp/claude-sonnet-5 oder openai/claude-sonnet-5. Manche Clients/CLIs stellen dem Modell einen Provider-Namen voran (z. B. ein Profil namens gp → das Modell heißt dann gp/claude-sonnet-5) → das Ergebnis ist 404 unknown model. Das Präfix gk- ist für API-Keys (den Authorization-Header), nicht für Modellnamen.

API-Key erstellen

Öffne das Dashboard → API-Key erstellen, gib ihm einen Namen und beschränke ihn (optional) auf bestimmte Modelle. Der Roh-Key wird nur einmal angezeigt. Bis zu 5 aktive Keys pro Konto — widerrufe einen alten, um einen neuen zu erstellen.

Fehlercodes

Status	Bedeutung
400	Falsche Base-URL / Body — stelle sicher, dass /v1 nicht doppelt vorkommt (z. B. /v1/v1/messages)
401	Ungültiger API-Key / falsche Spur — bezahlter Key ≠ Bansos-Key. Prüfe die Base-URL: bezahlt nutzt /v1, Bansos nutzt /v1/claude
402	Nicht genug GeraiPoints — bitte aufladen
403	Modell für diesen Key nicht erlaubt
404	Unbekanntes Modell — sende den EXAKTEN MODELLNAMEN (z. B. claude-sonnet-5), ohne Präfix. Namen wie gp/claude-sonnet-5 oder openai/... ergeben 404
429	Zu viele Requests