Get started in 2 minutes.

The Geraikita AI API supports two formats at once: OpenAI Chat Completions and Anthropic Messages. Use the OpenAI SDK, Anthropic SDK, Claude Code CLI, Cline, and other tools — just change the base URL and API key.

Authentication

Every request carries your gk- API key in the Authorization: Bearer gk-... header. Keys are created in the dashboard and shown only once at creation — store them safely. You can restrict each key to specific models (allowlist).

First 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 uses the Anthropic format. Set the base URL to the root (https://ai.geraikita.com — without /v1), then run claude. Use the models claude-sonnet-5 / claude-opus-5 / claude-haiku-4-5.

# Base URL = ROOT without /v1 (Claude Code appends /v1/messages itself)
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 & other tools

OpenCode

OpenCode reads its providers from a config file. Register Geraikita as an OpenAI-compatible provider in ~/.config/opencode/opencode.json, or in a project-level 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" }
      }
    }
  }
}

Then export your key and start OpenCode. Pick the model with /models — it shows up as geraikita/claude-sonnet-5.

export GERAIKITA_API_KEY=gk-xxxxxxxx
opencode

Important: the keys under models are sent to the API as-is, so they must match Geraikita's public model ids exactly.

Reminder: write the model name exactly as it appears on the pricing page — no prefix.

9router

9router is a local proxy that fans out to many providers and listens on http://localhost:20128. You don't point your tools at Geraikita directly — you register Geraikita as one of 9router's upstream providers.

1. Open the 9router dashboard at http://localhost:20128/dashboard.
2. Go to Providers and add a custom OpenAI-compatible endpoint: Base URL https://ai.geraikita.com/v1, API key gk-xxxxxxxx.
3. Leave your coding tools pointing at 9router (http://localhost:20128/v1) and just select a Geraikita model — 9router forwards those requests to Geraikita.

# your tool keeps pointing at 9router, not at Geraikita
export OPENAI_BASE_URL="http://localhost:20128/v1"

That way you keep 9router's routing and fallback across providers, while the tokens are paid from your Geraikita GeraiPoints.

Reminder: write the model name exactly as it appears on the pricing page — no prefix.

Hermes

Hermes (NousResearch's Hermes Agent) works with any OpenAI-compatible endpoint. Point it at Geraikita in ~/.hermes/config.yaml.

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

Or run hermes model, choose Custom OpenAI-compatible endpoint, and enter the base URL plus your key — Hermes then discovers the available models itself via GET https://ai.geraikita.com/v1/models.

Reminder: write the model name exactly as it appears on the pricing page — no prefix.

GeraiPoints

Model list

The model values you can send. See the pricing page for each model's rates.

Create an API key

Error codes