Begin binnen 2 minuten.

De Geraikita-AI-API ondersteunt twee formaten tegelijk: OpenAI Chat Completions en Anthropic Messages. Gebruik de OpenAI SDK, Anthropic SDK, Claude Code CLI, Cline en andere tools — verander alleen de base URL en de API-key.

Authenticatie

Elke request draagt je gk--API-key in de header Authorization: Bearer gk-.... Keys worden aangemaakt in het dashboard en alleen bij het aanmaken één keer getoond — bewaar ze veilig. Je kunt elke key beperken tot specifieke modellen (allowlist).

Eerste 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 gebruikt het Anthropic-formaat. Zet de base URL op de root (https://ai.geraikita.com — zonder /v1) en voer dan claude uit. Gebruik de modellen claude-sonnet-5 / claude-opus-5 / claude-haiku-4-5.

# Base URL = ROOT zonder /v1 (Claude Code voegt zelf /v1/messages toe)
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 & andere tools

OpenCode

OpenCode leest zijn providers uit een configuratiebestand. Registreer Geraikita als OpenAI-compatibele provider in ~/.config/opencode/opencode.json, of in een opencode.json van je project.

{
  "$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" }
      }
    }
  }
}

Exporteer daarna je key en start OpenCode. Kies het model met /models — het verschijnt als geraikita/claude-sonnet-5.

export GERAIKITA_API_KEY=gk-xxxxxxxx
opencode

Belangrijk: de keys onder models worden ongewijzigd naar de API gestuurd en moeten dus exact overeenkomen met de publieke model-ids van Geraikita.

Let op: schrijf de modelnaam precies zoals op de prijzenpagina — zonder prefix.

9router

9router is een lokale proxy die verzoeken over veel providers verdeelt en draait op http://localhost:20128. Je richt je tools niet direct op Geraikita — je registreert Geraikita als een van de upstream-providers van 9router.

1. Open het 9router-dashboard op http://localhost:20128/dashboard.
2. Ga naar Providers en voeg een custom OpenAI-compatible endpoint toe: Base URL https://ai.geraikita.com/v1, API-key gk-xxxxxxxx.
3. Je coding-tools blijven naar 9router wijzen (http://localhost:20128/v1); kies daar simpelweg een Geraikita-model — 9router stuurt die verzoeken door naar Geraikita.

# je tool blijft naar 9router wijzen, niet naar Geraikita
export OPENAI_BASE_URL="http://localhost:20128/v1"

Zo houd je de routing en fallback over meerdere providers van 9router, terwijl de tokens uit je Geraikita-GeraiPoints worden betaald.

Let op: schrijf de modelnaam precies zoals op de prijzenpagina — zonder prefix.

Hermes

Hermes (de Hermes Agent van NousResearch) werkt met elk OpenAI-compatibel endpoint. Richt hem op Geraikita in ~/.hermes/config.yaml.

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

Of voer hermes model uit, kies Custom OpenAI-compatible endpoint en vul de base URL en key in — Hermes vindt de beschikbare modellen daarna zelf via GET https://ai.geraikita.com/v1/models.

Let op: schrijf de modelnaam precies zoals op de prijzenpagina — zonder prefix.

GeraiPoints

Modellenlijst

De model-waarden die je kunt versturen. Zie de prijzenpagina voor de tarieven per model.

API-key aanmaken

Foutcodes