Dokumentacja

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.

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

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

UwierzytelnianieBearer gk-... (lub x-api-key: gk-...)

Ważne — nie wpisuj /v1 dwa razy.

OpenAIhttps://ai.geraikita.com/v1Klienci OpenAI doklejają /chat/completions do base URL — baza kończy się więc na /v1.

Anthropic / Claude Code CLIhttps://ai.geraikita.comKlienci Anthropic (Claude Code CLI, SDK Anthropic) sami doklejają /v1/messages — baza idzie więc bez /v1.

Pomylisz się — ścieżka stanie się /v1/v1/messages → błąd 400.

Darmowy plan (Bansos) używa ODDZIELNEGO KLUCZA — nie Twojego płatnego klucza.

Klucz bansos trzeba najpierw odebrać na stronie Bansos (logowanie + weryfikacja przez Telegram, za darmo, raz na konto). Płatny klucz gk- z Panelu nie działa na endpoincie bansos, i odwrotnie — pomylenie ich zwraca 401 unauthorized.

Base URL bansos też jest inny niż płatny powyżej:

Base URL bansoshttps://ai.geraikita.com/v1/claude

OpenAIhttps://ai.geraikita.com/v1/claude/chat/completions

Anthropic / Claude Code CLIANTHROPIC_BASE_URL=https://ai.geraikita.com/v1/claudeSDK samo dokleja /v1/messages → https://ai.geraikita.com/v1/claude/v1/messages.

Wykrywanie modeliGET https://ai.geraikita.com/v1/claude/models

Cała reszta jest dokładnie taka sama jak w płatnym endpoincie.

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

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

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

Twoje narzędzie samo wykrywa modele? Endpoint GET https://ai.geraikita.com/v1/models jest dostępny. Jeśli jest pole „Gateway base URL”, które automatycznie dokleja /v1/models, wpisz w nie https://ai.geraikita.com (root), aby nie powstało /v1/v1/models.

GeraiPoints

1 GP = Rp1. Rozliczasz się za tokeny według rzeczywistego zużycia każdego zapytania — bez stałej opłaty za zapytanie, tylko niewielkie minimum za zapytanie dla każdego modelu (podłoga). Doładuj GeraiPoints w panelu; saldo nigdy nie wygasa i działa z każdym modelem. Bez subskrypcji i miesięcznych limitów.

Lista modeli

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

Wpisuj nazwę modelu DOKŁADNIE tak, jak na liście — bez prefiksu. Wysyłaj claude-sonnet-5, nie gp/claude-sonnet-5 ani openai/claude-sonnet-5. Niektóre klienty/CLI doklejają do modelu nazwę dostawcy (np. profil o nazwie gp → model staje się gp/claude-sonnet-5) → wynik to 404 unknown model. Prefiks gk- jest dla kluczy API (nagłówek Authorization), nie dla nazw modeli.

Utwórz klucz API

Otwórz Panel → Utwórz klucz API, nadaj mu nazwę i (opcjonalnie) ogranicz go do konkretnych modeli. Surowy klucz jest pokazywany tylko raz. Do 5 aktywnych kluczy na konto — unieważnij stary, aby utworzyć nowy.

Kody błędów

Status	Znaczenie
400	Zły base URL / body — upewnij się, że /v1 nie występuje podwójnie (np. /v1/v1/messages)
401	Nieprawidłowy klucz API / zły tor — klucz płatny ≠ klucz bansos. Sprawdź base URL: płatny używa /v1, bansos używa /v1/claude
402	Za mało GeraiPoints — doładuj proszę
403	Model niedozwolony dla tego klucza
404	Nieznany model — wyślij DOKŁADNĄ NAZWĘ MODELU (np. claude-sonnet-5), bez prefiksu. Nazwy typu gp/claude-sonnet-5 albo openai/... dadzą 404
429	Za dużo zapytań