> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Використання ШІ

> Баланс токенів, витрати в часі, історія запитів і поповнення.

<Info>
  **Лише тариф Black.** Спільний бюджет обслуговує [AI Auto-Moderation](/uk/moderation/ai-auto-mod) і [AI Server Control](/uk/moderation/ai-server-control) — окремої норми на кожну функцію немає.
</Info>

## Два пули

Ваш баланс — сума двох пулів, які витрачаються в такому порядку:

<CardGroup cols={2}>
  <Card title="Monthly grant" icon="calendar">
    **10 000 000 токенів**, поповнюється кожні 30 днів. Невитрачені токени **не** переносяться.
  </Card>

  <Card title="Top-up" icon="plus">
    Токени, які ви купили. **Не закінчуються**, переживають продовження й зміни тарифу.
  </Card>
</CardGroup>

Грант завжди витрачається першим, тому поповнення — це справжній резерв, а не щось, що тихо тане щомісяця.

<Warning>
  **Показник «Resets in» відлічує від дати платежу, а не від циклу гранту.** На річній підписці Black там може бути кілька сотень днів, тоді як грант насправді поповнюється кожні 30 днів.

  Дивіться на саме число **Monthly grant** — коли воно повернеться до 10 000 000, цикл прокрутився.
</Warning>

## Огляд

| Плитка                     | Що показує                                         |
| -------------------------- | -------------------------------------------------- |
| **Token Balance**          | Грант плюс top-up — те, що можна реально витратити |
| **Tokens Used Today**      | Сьогоднішні витрати, у UTC                         |
| **Tokens Used This Month** | Від початку календарного місяця                    |
| **Requests Today**         | Кількість AI-викликів, а не токенів                |
| **Input / output tokens**  | Розбито на сьогодні й місяць                       |

<Note>
  День перевертається о **опівночі UTC**, а не за часовим поясом вашого сервера.
</Note>

<Note>
  Місячні числа кешуються до п'яти хвилин. Одразу після сплеску активності денні плитки оновлюються раніше за місячні — це не суперечність, вони просто мають різну частоту оновлення.
</Note>

Графік **Token Usage** будує вхід і вихід як складену область за 7, 14 або 30 днів. Дні без активності показуються як нуль, а не пропуски.

**Top Token Consumers** перелічує десятьох учасників, чия активність коштувала найбільше **сьогодні**, з кількістю запитів і середньою вартістю. З'являється тільки коли є що показати.

<Tip>
  Учасник, що день у день сидить угорі цього списку, зазвичай публікує багато зображень. Auto-Mod сканує до чотирьох зображень на повідомлення, а зображення коштують значно більше за текст.
</Tip>

## Activity

Кожен AI-запит, від нового, 20 на сторінку.

| Стовпець    | Примітки                                                                   |
| ----------- | -------------------------------------------------------------------------- |
| **Content** | Повідомлення, обрізане. Сканування Auto-Mod показується як «Auto-Mod scan» |
| **Tokens**  | Разом, з розбивкою на вхід і вихід                                         |
| **Source**  | «Auto-Mod», «AI Server Control» або учасник, що запитав                    |
| **Status**  | Completed, Failed, Blocked, Rate limited та інші                           |
| **Time**    | Відносно для нових, датою — для старших за добу                            |

Рядки AI Server Control розгортаються й показують кожну виконану дію — галочка для успіху, щит для відмови, хрестик для помилки — і скільки часу зайняла кожна.

<Note>
  Історія запитів зберігається **30 днів**. Графік і експорт сягають до 90 днів, тож старі витрати досі є в підсумках навіть після зникнення окремих рядків.
</Note>

<Warning>
  Прогон Server Control, який упав за таймаутом чи помилкою, тарифікується й враховується в підсумках, але не створює рядка в Activity. Якщо денна сума виглядає більшою, ніж пояснюють видимі рядки — саме тому.
</Warning>

## Експорт

**Export CSV** завантажує останні **30 днів** — по рядку на день з input, output і total tokens, кількістю запитів і кількістю дій. Селектор періоду на графіку не змінює вікно експорту.

## Поповнення

**\$1 за 500 000 токенів**, блоками 1, 5, 10, 25, 50 або 100 одиниць.

<Steps>
  <Step title="Оберіть суму">
    Діалог показує загальну кількість токенів і ціну під час вибору.
  </Step>

  <Step title="Завершіть оплату">
    Вас перекине на Paddle для оплати.
  </Step>

  <Step title="Токени нараховуються">
    Покупка додається до пулу top-up після підтвердження платежу.
  </Step>
</Steps>

<Note>
  Кнопка **Top Up Tokens** з'являється лише якщо на сервері активна підписка Black, оплачена через Paddle. Сервери з грантованим чи безкоштовним Black не мають прив'язаного платіжного методу і поповнити не можуть.
</Note>

<Warning>
  **Баланс не оновлюється в момент оплати.** Оновіть сторінку через хвилину; ще трохи часу знадобиться, перш ніж AI-функції відновляться, якщо вони вже були на паузі.
</Warning>

<Note>
  Кожна покупка нараховується рівно один раз, навіть якщо платіжний провайдер надсилає підтвердження двічі. Повернення коштів списують токени назад.
</Note>

## Коли бюджет закінчується

Дві функції зупиняються в різних точках, тому що прогону Server Control потрібно значно більше запасу, ніж скану одного повідомлення.

| Залишок       | Ефект                                                                |
| ------------- | -------------------------------------------------------------------- |
| Нижче 100 000 | Auto-Mod публікує одноразове «running low»                           |
| Нижче 30 000  | **AI Server Control відхиляє нові запити**                           |
| Нижче 3000    | **AI Auto-Moderation зупиняє сканування** і публікує «paused notice» |

<Warning>
  Auto-Mod працює **fail-closed**. Якщо не може підтвердити наявність бюджету — не сканує; ваш сервер залишається без AI-модерації, поки баланс не відновиться.
</Warning>

Повідомлення публікуються в alert-канал Auto-Mod, з відкатом на log-канал.

## Як тримати витрати низькими

<AccordionGroup>
  <Accordion title="Вимкніть сканування зображень">
    Найбільша економія одним кліком. Одне повідомлення з чотирма зображеннями коштує п'ять AI-викликів замість одного.
  </Accordion>

  <Accordion title="Увімкніть Trust Tiers">
    Давні чисті учасники будуть вибірково скануватися, а не щоразу — інвайти, масові згадки та посилання перевіряються завжди.
  </Accordion>

  <Accordion title="Виключіть активні низькоризикові канали">
    Канал команд бота чи канал мемів серед довірених регулярів рідко потребує платного сканування.
  </Accordion>

  <Accordion title="Вимкніть категорії, які не застосовуєте">
    Вимкнена категорія не оцінюється.
  </Accordion>
</AccordionGroup>

## Розв'язання проблем

<AccordionGroup>
  <Accordion title="Баланс нульовий, попри активний Black">
    Перезавантажте сторінку. Якщо триває — можливо, запис підписки саме для цього сервера не резолвиться; перевірте, що сервер з'являється у вашій підписці на сторінці Premium.
  </Accordion>

  <Accordion title="Я оплатив, але баланс не рухається">
    Дайте хвилину й перезавантажте. Якщо AI був на паузі — відновлення може зайняти трохи більше часу, ніж оновлення числа на панелі.
  </Accordion>

  <Accordion title="Export відкриває сирий текст замість завантаження">
    Це ознака збою входу під час завантаження. Перезавантажте панель, щоб оновилася сесія, і спробуйте знову.
  </Accordion>

  <Accordion title="Сьогоднішні токени великі, а список Activity виглядає коротко">
    Auto-Mod тарифікує один виклик на повідомлення плюс по одному на зображення — насичена картинками активність швидко множиться. Невдалі прогони Server Control теж тарифікуються без рядка.
  </Accordion>

  <Accordion title="Чи можна розділити бюджет між двома функціями?">
    Ні — пул один. Якщо Auto-Mod його з'їдає, посильте виключення та Trust Tiers, замість шукати ліміт на функцію.
  </Accordion>
</AccordionGroup>

<CardGroup cols={2}>
  <Card title="AI Auto-Moderation" icon="sparkles" href="/uk/moderation/ai-auto-mod">
    Звідки в основному йдуть витрати токенів.
  </Card>

  <Card title="AI і токени" icon="crown" href="/uk/premium/ai">
    Як влаштована AI-норма тарифу Black.
  </Card>
</CardGroup>