GeraikitaGeraikita AI
MenuSzybki start

Szybki start

Od zera do pierwszej odpowiedzi w trzech krokach: przygotuj base URL, utwórz klucz API i wyślij zapytanie.

Base URL

Klienci w formacie OpenAI używają base URL, który kończy się na /v1. Klienci w formacie Anthropic używają katalogu głównego bez /v1, bo ich SDK samo dokleja /v1/messages.

UstawienieWartośćUżywane przez
base_urlhttps://ai.geraikita.com/v1SDK OpenAI, Cline/Roo (OpenAI Compatible), OpenCode, n8n, Continue
base_urlhttps://ai.geraikita.comSDK Anthropic, Claude Code CLI, Cline (Anthropic)
api_keygk-…Wszyscy klienci — klucz tworzysz w Panelu

Utwórz klucz API

  1. Zaloguj się do Geraikita AI.
  2. Doładuj GeraiPoints na stronie Doładuj (albo odbierz darmowy klucz w Bansos).
  3. Otwórz Panel → Utwórz klucz API. Skopiuj klucz gk-… — pełny klucz jest wyświetlany tylko raz.
Trzymaj klucz w zmiennej środowiskowej, np. export GERAIKITA_API_KEY=gk-…, zamiast wpisywać go bezpośrednio w kodzie.

Pierwsze zapytanie

Wybierz język lub SDK, którego używasz. Wszystkie przykłady wywołują model claude-sonnet-5; zamień go na inne id z listy modeli.

curl https://ai.geraikita.com/v1/chat/completions \
  -H "Authorization: Bearer gk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "Cześć!"}]
  }'

Odpowiedź ma ten sam format JSON co API OpenAI (lub Anthropic, jeśli używasz /v1/messages), łącznie z obiektem usage zawierającym liczbę rozliczonych tokenów.

Odpowiedź w streamie

Przy długich odpowiedziach i narzędziach agentowych włącz stream, aby fragmenty odpowiedzi napływały od razu. Serwer natychmiast wysyła nagłówki, a w oczekiwaniu na pierwszy token — sygnały keepalive. Ustaw timeout aplikacji na co najmniej 300 sekund.

curl https://ai.geraikita.com/v1/chat/completions -N \
  -H "Authorization: Bearer gk-xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "stream": true,
    "messages": [{"role": "user", "content": "Cześć!"}]
  }'

Kolejne kroki