Документация

Старт за 2 минуты.

API Geraikita AI поддерживает два формата одновременно: OpenAI Chat Completions и Anthropic Messages. Используйте SDK OpenAI, Anthropic, Claude Code CLI, Cline и другие инструменты — достаточно сменить base URL и API-ключ.

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

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

АутентификацияBearer gk-... (или x-api-key: gk-...)

Важно — не пишите /v1 дважды.

OpenAIhttps://ai.geraikita.com/v1Клиенты OpenAI добавляют /chat/completions к base URL — поэтому base заканчивается на /v1.

Anthropic / Claude Code CLIhttps://ai.geraikita.comКлиенты Anthropic (Claude Code CLI, SDK Anthropic) сами добавляют /v1/messages — поэтому base идёт без /v1.

Ошибётесь — путь станет /v1/v1/messages → ошибка 400.

Бесплатный тариф (Bansos) использует ОТДЕЛЬНЫЙ КЛЮЧ — не платный.

Ключ bansos нужно сначала получить на странице Bansos (вход + подтверждение Telegram, бесплатно, 1 раз на аккаунт). Платный ключ gk- из Dashboard не работает на эндпоинте bansos, и наоборот — при путанице получите 401 unauthorized.

Base URL для bansos тоже отличается от платного выше:

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 сам добавляет /v1/messages → https://ai.geraikita.com/v1/claude/v1/messages.

Обнаружение моделейGET https://ai.geraikita.com/v1/claude/models

Остальное — точно так же, как у платного эндпоинта.

Аутентификация

Каждый запрос несёт ваш API-ключ gk- в заголовке Authorization: Bearer gk-.... Ключи создаются в dashboard и показываются только один раз при создании — храните их надёжно. Каждый ключ можно ограничить определёнными моделями (allowlist).

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

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 использует формат Anthropic. Установите base URL на корень (https://ai.geraikita.com — без /v1), затем запустите claude. Используйте модели claude-sonnet-5 / claude-opus-5 / claude-haiku-4-5.

# Base URL = корень без /v1 (Claude Code сам добавляет /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 и другие инструменты

Cline / Roo (OpenAI Compatible): провайдер OpenAI Compatible, Base URL https://ai.geraikita.com/v1, API-ключ gk-..., Model ID claude-sonnet-5.

Cline (Anthropic): провайдер Anthropic, Base URL https://ai.geraikita.com, API-ключ gk-....

Инструмент сам обнаруживает модели? Эндпоинт GET https://ai.geraikita.com/v1/models доступен. Если есть поле "Gateway base URL", автоматически добавляющее /v1/models, укажите https://ai.geraikita.com (корень), чтобы не получилось /v1/v1/models.

GeraiPoints

1 GP = 1 рупия. Оплата за токены по реальному использованию каждого запроса — без фиксированной платы за запрос, есть лишь небольшой минимум за запрос у каждой модели (нижний порог). Пополняйте GeraiPoints в dashboard; баланс не сгорает и подходит для любой модели. Никаких подписок и месячных квот.

Список моделей

Значения model, которые можно отправлять. Тарифы каждой модели — на странице цен.

Пишите имя модели ТОЧНО как в списке — без префикса. Отправляйте claude-sonnet-5, а не gp/claude-sonnet-5 или openai/claude-sonnet-5. Некоторые клиенты/CLI добавляют имя провайдера перед моделью (напр., профиль gp → модель читается как gp/claude-sonnet-5) → результат 404 неизвестная модель. Префикс gk- — для API-ключей (заголовок Authorization), а не для имён моделей.

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

Откройте Dashboard → Создать API-ключ, задайте имя и (опционально) ограничьте определёнными моделями. Сам ключ показывается только один раз. Максимум 5 активных ключей на аккаунт — отзовите старый, чтобы создать новый.

Коды ошибок

Статус	Значение
400	Неверный base URL / body — проверьте, нет ли двойного /v1 (напр., /v1/v1/messages)
401	Неверный API-ключ / перепутаны каналы — платный ключ ≠ ключ bansos. Проверьте base URL: платный использует /v1, bansos — /v1/claude
402	Недостаточно GeraiPoints — пополните баланс
403	Модель не разрешена для этого ключа
404	Неизвестная модель — отправьте ТОЧНОЕ ИМЯ МОДЕЛИ (напр., claude-sonnet-5), без префикса. Имена вроде gp/claude-sonnet-5 или openai/... дадут 404
429	Слишком много запросов