GeraikitaGeraikita AI
МенюБыстрый старт

Быстрый старт

От нуля до первого ответа за три шага: задайте base URL, создайте API-ключ и отправьте запрос.

Base URL

Клиенты формата OpenAI используют base URL, который заканчивается на /v1. Клиенты формата Anthropic используют корень без /v1, потому что их SDK сам добавляет /v1/messages.

ПараметрЗначениеКто использует
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-…Все клиенты — ключ создаётся в Dashboard

Создание API-ключа

  1. Войдите в Geraikita AI.
  2. Пополните GeraiPoints на странице Пополнить (или получите бесплатный ключ в Bansos).
  3. Откройте Dashboard → Создать API-ключ. Скопируйте ключ gk-… — полный ключ показывается только один раз.
Храните ключ в переменной окружения, например export GERAIKITA_API_KEY=gk-…, а не прямо в коде.

Первый запрос

Выберите язык или SDK. Все примеры вызывают модель claude-sonnet-5; замените её на другой id модели из списка моделей.

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": "Привет!"}]
  }'

Ответ приходит в JSON того же вида, что и у API OpenAI (или Anthropic при использовании /v1/messages), включая объект usage с количеством оплачиваемых токенов.

Потоковый ответ (stream)

Для длинных ответов и агентных инструментов включите stream, чтобы части ответа приходили сразу. Сервер мгновенно отправляет заголовки и сигналы keepalive, пока ждёт первый токен. Установите timeout приложения не менее 300 секунд.

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": "Привет!"}]
  }'

Что дальше