Тарифы, кредиты и биллинг
Кредит — единица, которой платформа измеряет оплаченную работу моделей: каждый запрос к языковой
модели (LLM), каждая индексация документа и каждая расшифровка записи уменьшают баланс рабочего
пространства. Тарифный план задаёт бюджет пространства в кредитах и лимиты на объём хранилища
и количество объектов. Тарифы, журнал списаний и журнал блокировок собраны в группе Платформа
раздела Администрирование и доступны только пользователям с глобальной ролью admin. Баланс
принадлежит пространству, а не человеку: все участники тратят общий бюджет.
Что вам понадобится
- глобальная роль
admin— вся группа Платформа закрыта для остальных пользователей; - заведённые AI-модели с заполненными ставками: без ставки списание за модель равно нулю;
- решение о том, какой план становится тарифом по умолчанию для новых пространств;
- список пространств, которым нужно назначить тариф и выдать стартовый бюджет.
За что платформа списывает кредиты
Платформа списывает кредиты за обращения к моделям: языковым, эмбеддингам и распознаванию речи. Стоимость запроса определяет сама модель, а не тариф пространства: тариф задаёт бюджет, модель — цену. Ставки вы задаёте в карточке модели, в секции «Тарификация и доступность».
| Единица списания | Как считается количество | Поля со ставками |
|---|---|---|
1 млн токенов | Платформа считает входные и выходные токены раздельно | Входные токены, Выходные токены |
минута | Платформа округляет длительность записи вверх до целой минуты | Кредиты за минуту |
Стоимость входных и выходных токенов платформа округляет до сотых долей кредита по отдельности и
затем складывает — поэтому суммы в журнале всегда с двумя десятичными знаками. Флажок «Бесплатная
модель» в карточке обнуляет ставки, и обращения к такой модели баланс не уменьшают. Единица
1 тыс. токенов осталась от прежней схемы тарификации: для новых моделей выбирайте 1 млн токенов.
Каждой операции платформа присваивает идентификатор и записывает списание ровно один раз. Повторная доставка того же запроса — переподключение потока ответа, повтор вебхука, повторная попытка интеграции — второй раз баланс не уменьшает.
Начисляет кредиты платформа в двух случаях: при создании рабочего пространства и при назначении пространству тарифа. Новое начисление обнуляет прежний остаток, неизрасходованные кредиты на следующий период не переносятся.
Как настроить тарифный план
Откройте Администрирование → Платформа → Биллинг и лимиты
(/settings/administration/platform/billing). Вкладка Тарифы содержит таблицу планов с колонками
Название, Код и Статус. Нажмите строку плана — справа откроется панель «Лимиты тарифа»
со всеми настройками.
| Настройка | Что задаёт |
|---|---|
| Кредиты в месяц | Бюджет, который пространство получает при назначении тарифа |
| Тариф по умолчанию | План для новых персональных пространств и предвыбор в форме создания пространства |
| Переключатель рядом с лимитом | Учитывать лимит при проверке операций |
| Без ограничений | Снять числовое ограничение, оставив лимит включённым |
Нажмите Сохранить внизу панели — платформа запишет и бюджет, и лимиты. Кнопка Отмена закрывает панель без записи. Признак тарифа по умолчанию переносится: включение его у одного плана снимает признак у прежнего.
Примечание. Тарифные планы платформа заводит при развёртывании инсталляции: в интерфейсе вы меняете кредиты, лимиты и признак тарифа по умолчанию, но не название, код и описание плана.
Инсталляция поставляется с тремя планами: FREE, PRO и ENTERPRISE. У плана ENTERPRISE лимиты
сняты, у FREE и PRO набор лимитов одинаковый и требует настройки под вашу инсталляцию. Вкладка
Использование отключена и помечена Скоро.
Какие лимиты задаёт тариф
Лимиты тарифа ограничивают не кредиты, а объём и количество: сколько места занимают файлы и векторы и сколько объектов существует в пространстве. Лимиты не управляют расходом кредитов — его ограничивает баланс.
| Лимит | Что ограничивает | Единица |
|---|---|---|
| Хранилище | Общий объём файлов пространства | Байты, с выбором bytes, MB, GB |
| Qdrant storage | Объём векторного хранилища | Байты, с выбором bytes, MB, GB |
| Ассистенты | Количество ассистентов | Штуки (count) |
| Действия | Количество действий | Штуки (count) |
| Базы знаний | Количество баз знаний | Штуки (count) |
| Участники | Количество участников пространства | Штуки (count) |
Первые два лимита панель показывает в группе Storage, остальные — в группе Objects. Лимиты,
у которых нет карточки в каталоге, панель собирает в группу Прочее и подписывает техническим
ключом: TOKEN_LLM, TOKEN_EMBEDDINGS и ASR_MINUTES ограничивают токены и минуты за расчётный
период.
Важно. Лимит срабатывает при достижении значения, а не при превышении: значение
0запрещает операцию полностью.
Как назначить тариф пространству и скорректировать баланс
Откройте Администрирование → Доступ → Рабочие пространства
(/settings/administration/access/workspaces) и нажмите строку пространства. Тариф, файловый
провайдер и баланс вы настраиваете в боковой панели, которая откроется справа.
- Выберите план в списке Тариф.
- Нажмите Сохранить изменения внизу панели.
- Убедитесь, что в блоке Баланс обновилось значение Текущий.
Смена тарифа сразу начисляет бюджет нового плана и обнуляет прежний остаток. Кнопка Сбросить возвращает поля к сохранённым значениям.
Чтобы выдать или снять кредиты вручную, заполните в блоке Баланс поле Изменение: положительное
число начисляет, отрицательное списывает (500 или -2.25). Заполните поле Причина — с пустой
причиной кнопка Скорректировать остаётся неактивной. Нажмите Скорректировать: корректировка
работает отдельно от кнопки Сохранить изменения и тариф не меняет. Списать больше, чем есть
на счёте, платформа не даст.
Поле Пополнение показывает расчётную дату следующего начисления. Сам по себе бюджет к этой дате не обновляется: чтобы продлить его, начислите кредиты корректировкой баланса или назначьте пространству другой тариф.
Важно. Понижение тарифа платформа отклоняет, если текущее потребление пространства уже превышает лимиты нового плана.
Как разобраться, куда ушли кредиты
Откройте Администрирование → Платформа → Журнал списаний
(/settings/administration/platform/billing/charges). Журнал показывает каждое списание отдельной
строкой, от новых к старым, с постраничным разбиением внизу.
| Колонка | Что показывает |
|---|---|
| Дата | Момент операции |
| Пространство | Чей баланс уменьшился |
| Модель | Отображаемое имя и ключ модели |
| Тип | Тип модели: LLM, EMBEDDINGS, ASR |
| Единица | Единица списания модели |
| Цена/ед. | Ставка, применённая к операции |
| Кол-во | Количество единиц: доли миллиона токенов или минуты |
| Итого | Сумма списания в кредитах |
Для моделей с единицей 1 млн токенов в колонке Цена/ед. показана ставка входных токенов, а
колонка Итого уже учитывает обе ставки — входную и выходную.
Примечание. Журнал содержит только списания за работу моделей: начисления по тарифу и ручные корректировки в него не попадают, поэтому остаток не сходится с суммой списаний.
Как читать журнал блокировок
Откройте Администрирование → Платформа → Журнал блокировок
(/settings/administration/platform/billing/blocks). Сюда попадают операции, которые платформа
остановила по лимитам тарифа. Журнал отвечает на вопрос, почему у пространства перестала проходить
операция. Кнопка Обновить перечитывает записи.
Отобрать записи можно по полям Период, Пространство, Операция, Ресурс и Причина. Три последних поля — наборы флажков: пустой набор означает «все». Кнопка Сбросить фильтры появляется, когда выбран хотя бы один фильтр.
| Причина | Что произошло |
|---|---|
| Лимит исчерпан | Операция достигла лимита тарифа |
| Операция запрещена | Тип операции недоступен пространству |
| Ограничено планом | Возможность закрыта тарифным планом |
| Пространство приостановлено | Пространство переведено в неактивное состояние |
| Другая причина | Причину определить не удалось |
Колонка Режим показывает, чем закончилось событие: HARD — операция остановлена, SOFT — операция
пропущена, а запись оставлена для анализа. Режим задаёт переменная окружения
GUARD_BLOCKING_MODE со значениями HARD (по умолчанию), SOFT и DISABLED.
Нажмите строку — откроется панель «Детали блокировки»: идентификатор события, операция, ресурс,
причина, признак Апгрейд, текст сообщения, Request ID и актор. Ниже идут блоки «Ожидаемый
расход», «Снимок потребления» и «Дополнительные данные» — по ним видно, какое значение
лимита сработало.
Частые вопросы
Почему в новом пространстве не проходят запросы к модели
У преднастроенных планов FREE и PRO лимиты TOKEN_LLM, TOKEN_EMBEDDINGS и ASR_MINUTES равны
нулю, а нулевой лимит запрещает операцию полностью. Проверьте:
- в панели «Лимиты тарифа» задано ненулевое значение либо включён флажок Без ограничений;
- в блоке Баланс пространства остаток больше нуля;
- в журнале блокировок нет свежих записей с причиной Лимит исчерпан.
Почему появляется сообщение «Недостаточно кредитов»
Баланс пространства меньше стоимости запроса, и платформа отклоняет операцию до обращения к модели. В тексте сообщения платформа показывает доступный и требуемый объём и имя модели. Начислите кредиты корректировкой баланса или назначьте пространству тариф с большим бюджетом.
Почему тариф не открывает доступ к возможностям
Тариф управляет бюджетом и лимитами, а доступ к возможностям платформы вы открываете отдельно — правилами в разделе Администрирование → Доступ → Функции. Пространство с самым дорогим тарифом не получит AI-импорт документов или режим агента, пока правило доступа не разрешит функцию.
Может ли владелец пространства сменить тариф сам
Смена тарифа доступна не только администратору инсталляции: участник с правом
workspace:plan:manage меняет план в разделе Настройки пространства → Тариф. Там же участник
видит остаток, включённый объём по плану и дату следующего пополнения, а расход по видам ресурсов —
в разделе Настройки пространства → Потребление.
Что дальше
- Раздел администрирования — карта всех разделов и групп меню.
- Модели и политики — задать ставки, по которым платформа считает стоимость запроса.
- Доступ, пользователи и пространства — создать пространство и выдать доступ к функциям.
- Центр активности — посмотреть, какие запуски привели к списаниям.