# Баланс для ИИ

«Баланс для ИИ» — отдельный счёт, с которого оплачиваются обращения к моделям: ответы в [ИИ-чате](https://support.watbot.ru/ai/chat), ответы [AI-агента](https://support.watbot.ru/chatbots/blocks/ai-agent) в боте и [сборка бота](https://support.watbot.ru/chatbots/ai-builder). Абонентской платы нет: списывается только стоимость того, что модель действительно сделала.

Счёт один на весь аккаунт и общий для всех ваших проектов. Валюта — та же, что у баланса кабинета.

> [!NOTE]
> База знаний оплачивается иначе — помесячно с баланса кабинета. «Баланс для ИИ» на неё не расходуется. Подробнее — на странице [Тариф и токены](https://support.watbot.ru/knowledge-bases/plan).

## Как пополнить

«Баланс для ИИ» пополняется переводом с баланса кабинета — один к одному, без комиссии.

1. Откройте раздел «Оплата» и в меню справа выберите «ИИ-баланс».
2. Нажмите «Пополнить».
3. В окне «Пополнение Баланса для ИИ» введите сумму. Она должна быть не точнее копейки, например 500 или 99.90.
4. Нажмите «Пополнить».

Над полем суммы показан «Внутренний баланс» — сколько денег на балансе кабинета, под полем — текущий «ИИ-баланс».

Если на балансе кабинета не хватает денег, откроется окно «Недостаточно средств» с суммой, которой не хватает: сначала пополните баланс кабинета, перевод выполнится следом.

> [!IMPORTANT]
> На «Баланс для ИИ» переводятся только деньги. Баллы для пополнения не используются.

Под балансом — «История пополнений»: дата и сумма каждого перевода. Текущий «ИИ-баланс» виден и на страницах «Тариф» и «Операции» рядом с балансом кабинета и баллами.

Пополнить «Баланс для ИИ» можно и прямо из чата: когда средства закончились, владелец проекта видит над полем ввода кнопку «Пополнить».

## Кто платит

Расход списывается с «Баланса для ИИ» **владельца проекта**. Если в ИИ-чате проекта работает сотрудник или в боте проекта отвечает AI-агент — платит владелец. Свой «Баланс для ИИ» сотруднику для работы в чужом проекте не нужен.

## Как считается стоимость

Модели считают текст в токенах. Токен — это слово или часть слова. Цена модели указана за миллион токенов, отдельно за вход и за выход.

- **Входящие токены** — всё, что модель получила: ваш вопрос, вся предыдущая переписка диалога, прикреплённые документы, результаты инструментов.
- **Исходящие токены** — то, что модель написала в ответ.

Стоимость ответа = входящие токены × цена входа + исходящие токены × цена выхода. Цены моделей — на странице [Цены дополнительных услуг](https://support.watbot.ru/billing/services), а в кабинете — в разделе [«ИИ-модели»](https://support.watbot.ru/ai/models).

Из этого следуют три правила экономии:

- **Длинный диалог дороже короткого.** С каждым новым сообщением модель заново получает всю историю. Для новой темы начинайте новый диалог, а длинный сокращайте пунктом «Сжать контекст».
- **Инструменты добавляют запросы.** Когда модель ищет в интернете или читает документ, она обращается к себе несколько раз подряд: спросила — получила результат — продолжила. Каждое такое обращение оплачивается.
- **Модель решает больше, чем длина вопроса.** Один и тот же ответ на разных моделях может отличаться по цене во много раз.

### Кэш промта

Начало запроса в длинном диалоге повторяется от сообщения к сообщению: та же инструкция, та же история. Часть моделей умеет запоминать это повторяющееся начало — это и есть кэш.

- **Из кэша** — токены, которые модель взяла из памяти, а не обработала заново. Они стоят дешевле обычного входа.
- **Запись в кэш** — токены, которые модель сохранила в память для следующих запросов.

Цены кэша указаны на странице модели: «Вход из кэша» и «Запись в кэш». Если у модели таких цен нет, эти токены считаются по обычной цене входа. Делать для этого ничего не нужно — кэш работает сам.

### Что оплачивается кроме ответов

- **Поиск в интернете** — каждый поиск оплачивается отдельно, сверх токенов.
- **Служебные запросы чата** — название диалога, заголовки шагов в ответе, определение языка документа. Их выполняет отдельная служебная модель; каждый виден в «Логах» отдельной строкой.
- **Сжатие контекста** — резюме пишет выбранная модель.
- **Остановленный ответ** — оплачивается та часть работы, которую модель успела выполнить до остановки.

## Когда средства закончились

Платформа проверяет «Баланс для ИИ» перед каждым ответом.

**В ИИ-чате.** Сообщение не отправляется и остаётся в поле ввода вместе с вложениями. Над полем появляется: «Недостаточно средств на Балансе для ИИ. Пополните баланс, чтобы продолжить.» Владелец проекта видит рядом кнопку «Пополнить», сотрудник — только сообщение.

Если средства закончились посреди ответа, в котором модель работает с инструментами, ответ останавливается. То, что модель успела написать, остаётся в диалоге.

**В боте с AI-агентом.** Агент не отвечает, срабатывает выход «Ошибка ИИ». Что с ним делать — на странице [AI-агент](https://support.watbot.ru/chatbots/blocks/ai-agent).

> [!WARNING]
> Ответ оплачивается после того, как он готов, поэтому последний ответ может увести баланс в небольшой минус. Минус погасится при следующем пополнении.

## «Логи»

Раздел «ИИ-модели» → «Логи». Здесь записано каждое обращение к модели в проекте, новые сверху.

| Колонка | Что показывает |
|---|---|
| «Время» | Когда выполнено обращение |
| «Провайдер» | Разработчик модели |
| «Модель» | Какая модель отвечала |
| «Входящие токены» | Сколько токенов получила модель. Ниже — сколько из них «из кэша» и «в кэш», если кэш использовался |
| «Исходящие токены» | Сколько токенов модель написала |
| «Тип» | Чем было обращение |
| «Стоимость» | Сколько списано с «Баланса для ИИ» |
| «Чат» | Ссылка на диалог, если обращение сделано из ИИ-чата |

Типы обращений:

- «Сообщение» — ответ в ИИ-чате;
- «Вызов инструментов» — обращение, в котором модель запросила инструмент;
- «Поиск в интернете» — сам поиск;
- «AI-агент» — ответ агента в боте;
- «Сжатие контекста», «Заголовок чата», «Заголовок шагов», «Язык OCR» — служебные запросы.

Один ответ в чате может занять несколько строк: модель запросила инструмент, получила результат, ответила.

Над таблицей — фильтры «Провайдер» и «Модель» и выбор периода.

> [!NOTE]
> Ссылка «Чат» открывает диалог, только если он ваш: диалоги личные, и чужой диалог по ссылке не откроется.

## «Статистика»

Раздел «ИИ-модели» → «Статистика». Два графика за выбранный период:

- **«Использование токенов»** — входящие и исходящие токены. Если использовался кэш, входящие разделены на обычные, «Из кэша» и «Запись в кэш».
- **«Запросы»** — число обращений к моделям.

Над графиками — период и детализация, фильтры «Провайдер» и «Модель», переключатель вида: линии или столбцы.

Статистика показывает токены и запросы, а не деньги. Сумму по обращениям смотрите в «Логах».

Такая же статистика по одной модели есть на странице модели в каталоге.

## Кто видит логи и статистику

Владелец проекта видит всё. Сотруднику нужны права «Просмотр логов» и «Просмотр аналитики» в группе «ИИ-Агенты / Чат» его роли. Как настроить роль — на странице [Доступ сотрудников](https://support.watbot.ru/chatbots/settings/access).

Сам «Баланс для ИИ» и его пополнение — в разделе «Оплата» у владельца аккаунта: каждый видит и пополняет только свой счёт.