Тарифы, кредиты и биллинг

Кредит — единица учёта работы моделей: запросов к языковой модели, индексации и распознавания речи. Списание зависит от операции, ставки модели и режима поставки. Тарифный план задаёт бюджет пространства в кредитах и лимиты на объём хранилища и количество объектов. Тарифы, журнал списаний и журнал блокировок собраны в группе Платформа раздела Администрирование и доступны только пользователям с глобальной ролью admin. Баланс принадлежит пространству, а не человеку: все участники тратят общий бюджет.

Что вам понадобится

• глобальная роль admin — вся группа Платформа закрыта для остальных пользователей;
• заведённые AI-модели с заполненными ставками: без ставки списание за модель равно нулю;
• решение о том, какой план становится тарифом по умолчанию для новых пространств;
• список пространств, которым нужно назначить тариф и выдать стартовый бюджет.

За что платформа списывает кредиты

Платформа списывает кредиты за обращения к моделям: языковым, эмбеддингам и распознаванию речи. Стоимость запроса определяет сама модель, а не тариф пространства: тариф задаёт бюджет, модель — цену. Ставки LLM и Embeddings вы задаёте в карточке модели, а ставку распознавания речи — в карточке системной модели SpeechRecognition v2.

Для ASR не нужен отдельный тарифный план. Откройте Администрирование → Платформа → AI-модели, выберите фильтр Тип: ASR и нажмите SpeechRecognition v2. В панели Тарификация ASR можно изменить только цену за начатую минуту или включить Бесплатное распознавание. Эту системную модель нельзя создать повторно, архивировать или перепривязать к другому провайдеру.

Стоимость входных и выходных токенов платформа округляет до сотых долей кредита по отдельности и затем складывает — поэтому суммы в журнале всегда с двумя десятичными знаками. Режим Бесплатная модель для LLM и Embeddings и Бесплатное распознавание для ASR обнуляет соответствующие ставки, и обращения к такой модели баланс не уменьшают. Единица 1 тыс. токенов осталась от прежней схемы тарификации: для новых моделей выбирайте 1 млн токенов.

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

При индексации базы знаний единица списания — порция фрагментов, отправленная в модель эмбеддингов. Кредиты списываются по расходу токенов, который вернула модель. Если расход не получен, порция баланс не уменьшает. Повторная обработка той же порции после перезапуска задачи не списывается второй раз, но разные порции одной задачи дают отдельные списания.

Построение портрета базы добавляет служебные обращения к языковой модели и эмбеддингам. Их оплачивает пространство-владелец; портреты системных баз с пространств не списываются — см. Системные базы знаний.

Начисляет кредиты платформа в двух случаях: при создании рабочего пространства и при назначении пространству тарифа. Новое начисление обнуляет прежний остаток, неизрасходованные кредиты на следующий период не переносятся.

Что происходит, когда кредиты закончились

В коробочной поставке нулевой баланс не останавливает запросы к модели, индексацию и действия: списания продолжают попадать в Журнал списаний. Баланс остаётся не ниже нуля, поэтому сумма списаний за период может превышать израсходованный остаток.

В облачной поставке недостаток кредитов блокирует операцию до обращения к модели. Сообщение Недостаточно кредитов содержит доступный и требуемый объём и имя модели. Поведение определяется режимом поставки, отдельного переключателя в админке нет.

Лимиты тарифа проверяются в обеих поставках независимо от баланса. События с причиной Лимит исчерпан попадают в Журнал блокировок: режим HARD останавливает операцию, SOFT оставляет запись, но пропускает её.

Как настроить тарифный план

Откройте Администрирование → Платформа → Биллинг и лимиты (/settings/administration/platform/billing). Вкладка Тарифы содержит таблицу планов с колонками Название, Код и Статус. Нажмите строку плана — справа откроется панель «Лимиты тарифа» со всеми настройками.

Нажмите Сохранить внизу панели — платформа запишет и бюджет, и лимиты. Кнопка Отмена закрывает панель без записи. Признак тарифа по умолчанию переносится: включение его у одного плана снимает признак у прежнего.

Примечание. Тарифные планы платформа заводит при развёртывании инсталляции: в интерфейсе вы меняете кредиты, лимиты и признак тарифа по умолчанию, но не название, код и описание плана.

Поставка содержит три преднастроенных плана; администратор может изменить их значения:

Вкладка Использование отключена и помечена Скоро.

Какие лимиты задаёт тариф

Лимиты тарифа ограничивают не кредиты, а объём и количество: сколько места занимают файлы и векторы и сколько объектов существует в пространстве. Лимиты не управляют расходом кредитов — его ограничивает баланс.

Первые два лимита панель показывает в группе Storage, остальные — в группе Objects. Лимиты, у которых нет карточки в каталоге, панель собирает в группу Прочее и подписывает техническим ключом: TOKEN_LLM, TOKEN_EMBEDDINGS и ASR_MINUTES ограничивают токены и минуты за расчётный период.

В поставляемых планах для TOKEN_LLM, TOKEN_EMBEDDINGS и ASR_MINUTES включено Без ограничений. Потолок токенов и минут по умолчанию не задан; расход кредитов ограничивается балансом в облачной поставке. Администратор может установить собственные лимиты.

У служебного пространства Системные базы знаний назначенный тариф виден в карточке, но его лимиты к этому пространству не применяются. Это исключение не отменяет технические ограничения и права доступа — см. Системные базы знаний.

Важно. Лимит срабатывает при достижении значения, а не при превышении: значение 0 запрещает операцию полностью.

Как назначить тариф пространству и скорректировать баланс

Откройте Администрирование → Доступ → Рабочие пространства (/settings/administration/access/workspaces) и нажмите строку пространства. Тариф и баланс настраиваются в боковой панели справа.

1. Выберите план в списке Тариф.
2. Нажмите Сохранить изменения внизу панели.
3. Убедитесь, что в блоке Баланс обновилось значение Текущий.

Смена тарифа сразу начисляет бюджет нового плана и обнуляет прежний остаток. Кнопка Сбросить возвращает поля к сохранённым значениям.

Чтобы выдать или снять кредиты вручную, заполните в блоке Баланс поле Изменение: положительное число начисляет, отрицательное списывает (500 или -2.25). Заполните поле Причина — с пустой причиной кнопка Скорректировать остаётся неактивной. Нажмите Скорректировать: корректировка работает отдельно от кнопки Сохранить изменения и тариф не меняет. Списать больше, чем есть на счёте, платформа не даст.

Поле Пополнение показывает расчётную дату следующего начисления. Сам по себе бюджет к этой дате не обновляется: чтобы продлить его, начислите кредиты корректировкой баланса или назначьте пространству другой тариф.

Важно. Понижение тарифа платформа отклоняет, если текущее потребление пространства уже превышает лимиты нового плана.

Как разобраться, куда ушли кредиты

Откройте Администрирование → Платформа → Журнал списаний (/settings/administration/platform/billing/charges). Журнал показывает каждое списание отдельной строкой, от новых к старым, с постраничным разбиением внизу.

Для моделей с единицей 1 млн токенов в колонке Цена/ед. показана ставка входных токенов, а колонка Итого уже учитывает обе ставки — входную и выходную.

Индексация одного документа даёт столько строк с типом EMBEDDINGS, сколько порций фрагментов ушло в модель. В журнале нет колонок с документом и номером порции, поэтому отличить эти строки от эмбеддингов поиска по одним колонкам нельзя. Сопоставляйте пространство, модель и время с историей индексаций базы знаний.

Примечание. Журнал содержит только списания за работу моделей: начисления по тарифу и ручные корректировки в него не попадают. В коробочной поставке списания также записываются после достижения нулевого баланса, поэтому их сумма может превышать израсходованный остаток.

Как читать журнал блокировок

Откройте Администрирование → Платформа → Журнал блокировок (/settings/administration/platform/billing/blocks). Сюда попадают операции, которые платформа проверила по лимитам тарифа. Журнал отвечает на вопрос, почему у пространства перестала проходить операция. Кнопка Обновить перечитывает записи.

Отобрать записи можно по полям Период, Пространство, Операция, Ресурс и Причина. Три последних поля — наборы флажков: пустой набор означает «все». Кнопка Сбросить фильтры появляется, когда выбран хотя бы один фильтр.

Колонка Режим показывает, чем закончилось событие: HARD — операция остановлена, SOFT — операция пропущена, а запись оставлена для анализа. Режим задаёт переменная окружения GUARD_BLOCKING_MODE со значениями HARD (по умолчанию), SOFT и DISABLED.

Нажмите строку — откроется панель Детали блокировки: ID события, Дата, Пространство, Операция, Ресурс, Причина, Сообщение, Request ID и Актор. Ниже показаны Ожидаемый расход, Снимок потребления и Дополнительные данные — по ним можно понять, какое ограничение сработало.

Частые вопросы

Почему в новом пространстве не проходят запросы к модели

Проверьте действующие настройки пространства:

• в панели «Лимиты тарифа» задано ненулевое значение либо включён флажок Без ограничений;
• в облачной поставке в блоке Баланс остаток достаточен для запроса;
• в журнале блокировок нет свежих записей с причиной Лимит исчерпан.

Почему появляется сообщение «Недостаточно кредитов»

Инсталляция работает в облачной поставке, а баланс пространства меньше стоимости запроса. Платформа отклоняет операцию до обращения к модели. В тексте сообщения платформа показывает доступный и требуемый объём и имя модели. Начислите кредиты корректировкой баланса или назначьте пространству тариф с большим бюджетом.

Почему выросли списания за индексацию

Индексация учитывается по каждой порции эмбеддингов. До версии 1.2 в журнал могла попадать только первая порция задачи, что занижало сумму. Рост суммы после обновления сам по себе не означает изменение ставки модели: сравните ставку и количество обработанных порций.

Почему тариф не открывает доступ к возможностям

Тариф управляет бюджетом и лимитами, а доступ к возможностям платформы вы открываете отдельно — правилами в разделе Администрирование → Доступ → Функции. Пространство с самым дорогим тарифом не получит переключатель Чат/Агент, пока не разрешена функция Режим сценария в Ассистентах. Режим Авто у системного ассистента дополнительно требует функции Режим «Авто» у Уники AI.

Может ли владелец пространства сменить тариф сам

Смена тарифа доступна не только администратору инсталляции: участник с правом workspace:plan:manage меняет план в разделе Настройки пространства → Тариф. Там же участник видит остаток, включённый объём по плану и дату следующего пополнения, а расход по видам ресурсов — в разделе Настройки пространства → Потребление.

Что дальше

• Системные базы знаний — служебное пространство, портреты и учёт расходов.
• Раздел администрирования — карта всех разделов и групп меню.
• Модели и политики — задать ставки, по которым платформа считает стоимость запроса.
• Доступ, пользователи и пространства — создать пространство и выдать доступ к функциям.
• Центр активности — посмотреть, какие запуски привели к списаниям.