Введение

Nika Gateway — предоплатный API-шлюз к языковым и медиа-моделям. Вы пополняете баланс в рублях, получаете API-ключ и вызываете модели разных провайдеров через единый OpenAI-совместимый endpoint — без отдельных аккаунтов и биллинга у каждого провайдера.

Возможности

• Единый API. Один endpoint /v1/chat/completions для OpenAI, Anthropic, Kimi, DeepSeek, Xiaomi MiMo и GLM, нативный /v1/messages для клиентов вроде Claude Code и /v1/audio/transcriptions для распознавания речи (Deepgram). Модель адресуется slug'ом вида провайдер/модель.
• Оплата за фактическое использование. Деньги списываются по факту токенов (для аудио — по секундам). Подписок нет, баланс не сгорает.
• PII-маскирование. Автоматическое вырезание персональных данных из запросов с восстановлением в ответах — настраивается на API-ключ.
• Прозрачная стоимость. В каждый ответ шлюз добавляет usage.cost_rub (стоимость запроса) и usage.balance (остаток баланса).
• Контроль расходов. Бюджеты на API-ключ с авто-сбросом, сроки жизни ключей, ограничение списка моделей, rate limiting.
• Работа с юрлицами. Пополнение по счёту, договор-оферта, ежемесячные акты и реестр операций.

Как это работает

1. Вы регистрируетесь в личном кабинете и пополняете баланс.
2. Создаёте API-ключ вида sk-tunnel-* — с бюджетом и сроком жизни при необходимости.
3. Отправляете запросы на https://api.nikagateway.ru/v1/... в привычном OpenAI-формате — через SDK, cURL или любой совместимый клиент.

Перед запросом шлюз резервирует максимальную стоимость, после ответа списывает фактическую и возвращает излишек резерва. Баланс не может уйти в минус — подробнее в разделе Биллинг.

С чего начать

• Быстрый старт — первый запрос за пять минут: cURL, JavaScript и Python.
• Аутентификация — формат ключей и заголовки.
• Модели и провайдеры — доступные модели и их slug'и.
• Claude (Anthropic) — нативный /v1/messages и Claude Code через Nika Gateway.
• Распознавание речи — транскрибация аудио через Deepgram.
• PII-маскирование — вырезание персональных данных из запросов.
• Коды ошибок — 401, 402, 403, 429 и как на них реагировать.
• Для юридических лиц — счета, акты и закрывающие документы.