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.

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

OpenCode

OpenCode liest seine Provider aus einer Konfigurationsdatei. Registriere Geraikita als OpenAI-kompatiblen Provider in ~/.config/opencode/opencode.json oder in einer projektweiten opencode.json.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "geraikita": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Geraikita AI",
      "options": {
        "baseURL": "https://ai.geraikita.com/v1",
        "apiKey": "{env:GERAIKITA_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": { "name": "Claude Sonnet 5" },
        "gpt-5.6-sol": { "name": "GPT 5.6 Sol" },
        "deepseek-v4-pro": { "name": "DeepSeek V4 Pro" }
      }
    }
  }
}

Exportiere dann deinen Key und starte OpenCode. Das Modell wählst du mit /models — es erscheint als geraikita/claude-sonnet-5.

export GERAIKITA_API_KEY=gk-xxxxxxxx
opencode

Wichtig: die Schlüssel unter models werden unverändert an die API gesendet und müssen daher exakt den öffentlichen Modell-IDs von Geraikita entsprechen.

Denk daran: schreibe den Modellnamen genau so wie auf der Preisseite — ohne Prefix.

9router

9router ist ein lokaler Proxy, der Anfragen auf viele Provider verteilt und unter http://localhost:20128 läuft. Du richtest deine Tools nicht direkt auf Geraikita — stattdessen registrierst du Geraikita als einen der Upstream-Provider von 9router.

1. Öffne das 9router-Dashboard unter http://localhost:20128/dashboard.
2. Gehe zu Providers und füge einen custom OpenAI-compatible Endpunkt hinzu: Base URL https://ai.geraikita.com/v1, API-Key gk-xxxxxxxx.
3. Deine Coding-Tools zeigen weiterhin auf 9router (http://localhost:20128/v1); wähle dort einfach ein Geraikita-Modell — 9router leitet diese Anfragen an Geraikita weiter.

# dein Tool zeigt weiter auf 9router, nicht direkt auf Geraikita
export OPENAI_BASE_URL="http://localhost:20128/v1"

So behältst du Routing und Fallback über mehrere Provider von 9router, während die Tokens von deinen Geraikita-GeraiPoints bezahlt werden.

Denk daran: schreibe den Modellnamen genau so wie auf der Preisseite — ohne Prefix.

Hermes

Hermes (der Hermes Agent von NousResearch) funktioniert mit jedem OpenAI-kompatiblen Endpunkt. Richte ihn in ~/.hermes/config.yaml auf Geraikita.

model:
  default: claude-sonnet-5
  provider: custom
  base_url: https://ai.geraikita.com/v1
  api_key: gk-xxxxxxxx   # oder in ~/.hermes/.env ablegen

Oder führe hermes model aus, wähle Custom OpenAI-compatible endpoint und gib Base URL und Key ein — Hermes erkennt die verfügbaren Modelle dann selbst über GET https://ai.geraikita.com/v1/models.

Denk daran: schreibe den Modellnamen genau so wie auf der Preisseite — ohne Prefix.

GeraiPoints

Modellliste

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

API-Key erstellen

Fehlercodes