Баланс и списания
Один баланс на всё: чат, студию и API. Списание идёт по факту выполненного запроса, а не по подписке на модель, поэтому неиспользованное не сгорает в конце месяца.
Метод#
curl https://nirastudio.org/v1/account -H "Authorization: Bearer $NIRA_API_KEY"
Это самый дешёвый способ проверить ключ: он не обращается к моделям и ничего не списывает.
Поля ответа#
| Поле | Что означает |
|---|---|
email | Владелец ключа. Полезно, когда ключей несколько и надо понять, чей это |
plan | Код тарифа. API открывает «Про» |
plan_name | Название тарифа для интерфейса |
balance_usd | Всё, что есть на балансе, включая удержанное под незакрытые запросы |
held_usd | Удержано под запросы, которые уже начались, но ещё не посчитаны провайдером |
available_usd | Чем можно распоряжаться прямо сейчас: баланс минус удержания. Именно это поле стоит проверять перед пачкой запросов |
Зачем удержание#
Пока модель отвечает, точная стоимость неизвестна: она зависит от длины ответа, которой ещё нет. Шлюз резервирует оценку сверху, а когда провайдер сообщает фактический расход — пересчитывает и возвращает разницу. Поэтому available_usd во время работы агента ниже, чем balance_usd, и выравнивается через секунду после ответа.
Откуда берётся цена#
Стоимость запроса считается по отчёту провайдера о нём же, а не по прикидке длины текста на нашей стороне. Из этого следуют две вещи, которые обычно удивляют:
- Кэшированный ввод дешевле обычного — если провайдер отметил его как кэш, скидка приходит к вам, без ручных настроек.
- Рассуждение модели считается как выходные токены, даже если его текст вам не показали. Это не наша надбавка: так тарифицирует сам провайдер.
Цены по каждой модели — в каталоге, поштучно за токен. История собственных списаний — в разделе расхода: там видно модель, объём и стоимость каждого запроса.
Когда баланс кончился#
Запрос получает 402 и к модели не уходит — незакрытых долгов не возникает. Ключ при этом остаётся живым: после пополнения в тарифах он работает сразу, менять его в настройках клиента не нужно.
Агент в цикле
Автономный агент может съесть баланс за несколько минут — он не спрашивает разрешения на каждый шаг. Ограничьте ключ дневным лимитом в настройках: это единственный предел, который работает без вашего участия.