Zacznij w 2 minuty.

API Geraikita AI obsługuje dwa formaty naraz: OpenAI Chat Completions oraz Anthropic Messages. Używaj SDK OpenAI, SDK Anthropic, Claude Code CLI, Cline i innych narzędzi — wystarczy zmienić base URL i klucz API.

Uwierzytelnianie

Każde zapytanie niesie Twój klucz API gk- w nagłówku Authorization: Bearer gk-.... Klucze tworzy się w panelu i pokazywane są tylko raz przy utworzeniu — przechowuj je bezpiecznie. Każdy klucz możesz ograniczyć do konkretnych modeli (lista dozwolonych).

Pierwsze zapytanie

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 używa formatu Anthropic. Ustaw base URL na root (https://ai.geraikita.com — bez /v1), a potem uruchom claude. Używaj modeli claude-sonnet-5 / claude-opus-5 / claude-haiku-4-5.

# Base URL = ROOT bez /v1 (Claude Code sam dokleja /v1/messages)
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 i inne narzędzia

OpenCode

OpenCode czyta listę providerów z pliku konfiguracyjnego. Dodaj Geraikitę jako providera zgodnego z OpenAI w ~/.config/opencode/opencode.json albo w projektowym 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" }
      }
    }
  }
}

Następnie wyeksportuj klucz i uruchom OpenCode. Model wybierzesz przez /models — pojawia się jako geraikita/claude-sonnet-5.

export GERAIKITA_API_KEY=gk-xxxxxxxx
opencode

Ważne: klucze pod models lecą do API bez zmian, więc muszą dokładnie odpowiadać publicznym id modeli Geraikity.

Pamiętaj: wpisz nazwę modelu dokładnie tak, jak na stronie cen — bez prefiksu.

9router

9router to lokalny proxy, który rozdziela zapytania na wielu providerów i nasłuchuje na http://localhost:20128. Nie kierujesz narzędzi wprost do Geraikity — rejestrujesz Geraikitę jako jednego z providerów upstream 9routera.

1. Otwórz dashboard 9routera pod http://localhost:20128/dashboard.
2. Wejdź w Providers i dodaj endpoint custom OpenAI-compatible: Base URL https://ai.geraikita.com/v1, klucz API gk-xxxxxxxx.
3. Twoje narzędzia dalej wskazują na 9router (http://localhost:20128/v1) — wystarczy wybrać model Geraikity, a 9router przekaże te zapytania do Geraikity.

# twoje narzędzie dalej wskazuje na 9router, nie na Geraikitę
export OPENAI_BASE_URL="http://localhost:20128/v1"

W ten sposób zachowujesz routing i fallback między providerami z 9routera, a tokeny opłacasz z GeraiPoints w Geraikicie.

Pamiętaj: wpisz nazwę modelu dokładnie tak, jak na stronie cen — bez prefiksu.

Hermes

Hermes (Hermes Agent od NousResearch) działa z każdym endpointem zgodnym z OpenAI. Skieruj go na Geraikitę w ~/.hermes/config.yaml.

model:
  default: claude-sonnet-5
  provider: custom
  base_url: https://ai.geraikita.com/v1
  api_key: gk-xxxxxxxx   # albo umieść go w ~/.hermes/.env

Albo uruchom hermes model, wybierz Custom OpenAI-compatible endpoint i podaj base URL oraz klucz — Hermes sam wykryje dostępne modele przez GET https://ai.geraikita.com/v1/models.

Pamiętaj: wpisz nazwę modelu dokładnie tak, jak na stronie cen — bez prefiksu.

GeraiPoints

Lista modeli

Wartości model, które możesz wysyłać. Stawki poszczególnych modeli znajdziesz na stronie cennika.

Utwórz klucz API

Kody błędów