Documentatie

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.

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

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

AuthenticatieBearer gk-... (of x-api-key: gk-...)

Belangrijk — schrijf /v1 niet twee keer.

OpenAIhttps://ai.geraikita.com/v1OpenAI-clients voegen /chat/completions toe aan de base URL — de base eindigt dus op /v1.

Anthropic / Claude Code CLIhttps://ai.geraikita.comAnthropic-clients (Claude Code CLI, Anthropic SDK) voegen zelf /v1/messages toe — de base gaat dus zonder /v1.

Doe je het fout, dan wordt het pad /v1/v1/messages → fout 400.

De gratis tier (Bansos) gebruikt een APARTE KEY — niet je betaalde key.

Een bansos-key moet eerst worden geclaimd op de Bansos-pagina (inloggen + Telegram-verificatie, gratis, één keer per account). Een betaalde gk--key uit het Dashboard werkt niet op het bansos-endpoint, en omgekeerd — ze verwisselen geeft 401 unauthorized.

De bansos-base-URL is ook anders dan de betaalde hierboven:

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/claudeDe SDK voegt zelf /v1/messages toe → https://ai.geraikita.com/v1/claude/v1/messages.

Modellen ontdekkenGET https://ai.geraikita.com/v1/claude/models

Al het andere is precies hetzelfde als bij het betaalde endpoint.

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

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

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

Ontdekt je tool modellen automatisch? Het endpoint GET https://ai.geraikita.com/v1/models is beschikbaar. Is er een veld "Gateway base URL" dat automatisch /v1/models toevoegt, vul dan https://ai.geraikita.com (root) in zodat het geen /v1/v1/models wordt.

GeraiPoints

1 GP = Rp1. Je wordt per token afgerekend op basis van het echte verbruik van elke request — geen vaste kosten per request, alleen een klein minimum per request voor elk model (bodem). Waardeer GeraiPoints op in het dashboard; je saldo verloopt nooit en werkt bij elk model. Geen abonnementen of maandelijkse tegoeden.

Modellenlijst

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

Schrijf de modelnaam EXACT zoals vermeld — zonder prefix. Verstuur claude-sonnet-5, niet gp/claude-sonnet-5 of openai/claude-sonnet-5. Sommige clients/CLI's zetten een providernaam vóór het model (bijv. een profiel genaamd gp → het model wordt gp/claude-sonnet-5) → het resultaat is 404 unknown model. Het prefix gk- is voor API-keys (de Authorization-header), niet voor modelnamen.

API-key aanmaken

Open het Dashboard → API-key aanmaken, geef hem een naam en beperk hem (optioneel) tot specifieke modellen. De ruwe key wordt maar één keer getoond. Maximaal 5 actieve keys per account — trek een oude in om een nieuwe aan te maken.

Foutcodes

Status	Betekenis
400	Verkeerde base URL / body — controleer dat /v1 niet dubbel staat (bijv. /v1/v1/messages)
401	Ongeldige API-key / verkeerde rijstrook — betaalde key ≠ bansos-key. Controleer de base URL: betaald gebruikt /v1, bansos gebruikt /v1/claude
402	Niet genoeg GeraiPoints — waardeer op alsjeblieft
403	Model niet toegestaan voor deze key
404	Onbekend model — verstuur de EXACTE MODELNAAM (bijv. claude-sonnet-5), zonder prefix. Namen als gp/claude-sonnet-5 of openai/... geven 404
429	Te veel requests