betool betool

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

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

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

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

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

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

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

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

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

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

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

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

Два режима:

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

На тарифе Enterprise биллинг может быть переведён на ежемесячную постоплату с минимальным обязательством.

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

Администрирование → Биллинг → Потребление:

  • Текущий баланс
  • Потребление за 7 дней / 30 дней / произвольный диапазон
  • Топ-10 самых дорогих pipelines / agents
  • Разбивка по типу ресурса

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

Оповещения

Настройте до 5 порогов оповещений на организацию:

  • Низкий баланс — когда баланс опускается ниже X кредитов, уведомить Y (email, Mattermost, webhook).
  • Всплеск потребления — когда почасовое потребление превышает Z, немедленно оповестить.
  • Дорогой pipeline — когда конкретный pipeline потребляет больше ожидаемого.

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

Если вашего баланса недостаточно для выполнения вызова LLM или телефонного звонка, betool отклоняет выполнение до какого-либо списания. Вы увидите явное сообщение в истории, а pipeline будет отмечен как out_of_credits.

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

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

Если вы обращаетесь к admin API, эндпоинт /api/admin/billing/balance возвращает ваш баланс и кредитный лимит. Любой вызывающий код, перехватывающий Exception, должен сначала повторно выбросить OutOfCreditsError — это сигнал биллинга, а не бизнес-ошибка.