Nika Gateway

Биллинг

Предоплата, резерв средств, списание по факту и пополнение баланса

Биллинг

Модель оплаты

Предоплата. Вы пополняете баланс в рублях и тратите его на фактическое использование: токены LLM, секунды аудио (Deepgram), изображения и секунды видео (fal.ai). Подписок и обязательных платежей нет.

Главное свойство системы: баланс не может уйти в минус.

Как списываются деньги

1. Резерв перед запросом

Перед обращением к провайдеру шлюз оценивает максимальную стоимость запроса (вход × цена входа + максимальный выход × цена выхода, с небольшим запасом) и резервирует эту сумму на балансе. Если средств не хватает — запрос сразу получает 402 и к провайдеру не уходит.

2. Списание по факту

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

3. Ошибки провайдера

Если провайдер не отработал (5xx, таймаут), резерв возвращается полностью: вы платите только за подтверждённый результат.

Что видит клиент

В каждый нестриминг-ответ шлюз добавляет:

{
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 24,
    "cost_rub": "0.008420",
    "balance": "999.991580"
  }
}
  • cost_rub — списано за этот запрос;
  • balance — остаток баланса после списания.

При стриминге usage приходит в финальном SSE-чанке, списание — после завершения потока.

Кэш-токены

Если провайдер вернул кэшированные токены (cached_tokens, cache hit), они тарифицируются по сниженной ставке провайдера — скидка автоматически учитывается в cost_rub.

Пополнение баланса

  • По счёту (юрлица). Счёт формируется в кабинете, зачисление — после фактического поступления средств. Подробнее — для юридических лиц.
  • Банковской картой — появится после подключения эквайринга (МИР / Visa / Mastercard), включая сохранённые карты и авто-пополнение при низком балансе.

Возвраты

Возврат неизрасходованных средств выполняется по правилам оферты: по заявлению в течение 24 часов, комиссии платёжных систем не возвращаются.

Бюджеты на ключ

Дополнительно к общему балансу на каждый API-ключ можно задать собственный бюджет с авто-сбросом (день / неделя / месяц) — удобно для разграничения расходов между сервисами и средами. Исчерпание бюджета ключа — 403, баланс аккаунта при этом не тратится.