Документация

Кредиты и тарификация

Разберитесь в системе кредитов, отслеживайте потребление и настраивайте бюджетные оповещения.

betool взимает плату по факту использования в кредитах: 1 кредит = 0,0001 € (одна десятитысячная евро). Вы пополняете баланс заранее; каждое выполнение списывает соответствующую стоимость.

Зачем нужны кредиты

Система кредитов обеспечивает:

  • Высокую детализацию — вызов API стоимостью $0.000003 измерим без округления.
  • Стабильность цен — ваши удельные цены в кредитах не меняются, когда провайдер пересматривает свои тарифы.
  • Изоляцию по организациям — у каждой организации свой баланс и свои оповещения.

Что тарифицируется?

Подробности см. в разделе Цены. Кратко:

  • LLM — на управляемой модели за входной / выходной токен. В BYOK — ничего: вы платите своему провайдеру напрямую, betool ничего не берёт за токены.
  • Голос — ASR за секунду, TTS за символ.
  • Телефония — у звонка как такового нет поминутной цены: он тарифицируется по своим составляющим (транскрипция, синтез речи, LLM).
  • Операторы HTTP / DB / transform — не тарифицируются.

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

Два режима:

  • Вручную — через Параметры организации → План (кнопка Пополнить) добавьте разовую сумму.
  • Автопополнение — автоматическое пополнение, когда баланс опускается ниже порога. Рекомендуется во избежание перерывов в обслуживании.

Отслеживание потребления

Параметры организации → Потребление:

  • Текущий баланс
  • История потребления с фильтром по периоду
  • Разбивка по узлу pipeline и по типу ресурса

Таблицу можно экспортировать в Excel для интеграции с вашей внутренней отчётностью.

Оповещения

Два автоматических оповещения защищают ваш баланс:

  • Низкий баланс — когда баланс опускается ниже порога, администраторы организации получают уведомление (в приложении + по email).
  • Баланс исчерпан — когда баланс падает до нуля, немедленно отправляется отдельное оповещение.

Сочетайте их с автопополнением (порог + сумма, настраиваются для каждой организации), чтобы никогда не доходить до отключения.

Отказ до вызова

Если вашего баланса недостаточно для выполнения вызова LLM или телефонного звонка, betool отклоняет выполнение до какого-либо списания с явной ошибкой out of credits, видимой в истории.

Переплата невозможна: вызов никогда не начинается без доступного кредита.

Хранилище файлов

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

Использование отслеживается в Параметры организации → План, раздел Хранилище: использованный объём, израсходованная доля плана и индикатор, который сигнализирует о превышении 80 %, а затем о заполненном хранилище.

Лимит проверяется при каждой записи файла, до отправки в хранилище:

  • Записи, инициированные вашей организацией, — импорт в базу знаний, файлы, созданные узлом (загрузка, извлечение архива, разделение PDF, экспорт в Excel…): сверх лимита запись отклоняется, и ничего не записывается. Соответствующий узел уходит по своему пути ошибки; узел, создающий несколько файлов, удаляет уже записанные.
  • Файлы, отправленные вашими контактами, — вложения писем, медиафайлы мессенджеров, файлы, полученные через webhook: принимаются всегда, даже сверх лимита (сообщение клиента никогда не теряется), и учитываются в вашем использовании.

Чтобы освободить место: удалите файлы (удаление документа из базы знаний удаляет его файл) или перейдите на более высокий план.

Для разработчиков

Если вы обращаетесь к admin API, эндпоинт GET /api/admin/billing/state возвращает ваш план, баланс и состояние автопополнения; GET /api/admin/billing/storage-usage возвращает использование хранилища и его лимит. Запись файла, отклонённая из-за заполненного хранилища, отвечает 507 Insufficient Storage.