---
title: Пакеты
description: Один пакет на аккаунт: лимит в процентах от плана, докупка и минимальная покупка, какие ключи тратят пакет, заморозка, уведомления и чем пакет отличается от кошелька.
keywords: пакет, предоплата, лимит, план, докупка, пополнить до плана, минимальная покупка, заморозка, 402
group: account
---

## Что такое пакет {#what keywords="пакет, предоплата, лимит, аккаунт"}

Пакет — это **предоплаченный лимит токенов**, купленный заранее со скидкой по объёму. Он тратится токенами, а не деньгами, и кошелёк сам по себе не трогает.

**Пакет у аккаунта один.** Первая покупка его открывает, каждая следующая — пополняет тот же пакет. Выбирать, куда зачислить покупку, не нужно: зачислять больше некуда.

Тратит пакет любой ключ аккаунта, которому вы разрешили тратить из пакета, — а какие это ключи, решаете вы, ключ за ключом.

## План и лимит {#plan keywords="план, лимит, проценты, pro, max, ultra"}

**План** — это самая крупная разовая покупка пакета. По нему консоль называет группу пакета — **Pro, Max или Ultra** — и от него же отсчитывает остаток. Покупка меньше плана план не понижает; покупка крупнее — поднимает его до себя. Никаких привилегий к плану не прилагается: это только мерка, от которой считается шкала.

Остаток пакета показан как **лимит в процентах от плана**: сколько из плана ещё можно потратить. Если остаток после пополнения больше плана, шкала стоит на 100 %. Цвет шкалы меняется, когда остаток опускается ниже половины и ниже 20 %.

## Покупка и пополнение {#purchase keywords="покупка, докупка, пополнение, пополнить до плана, минимальная покупка, лестница"}

Цена покупки считается **по размеру самой этой покупки** на опубликованной лестнице цен: чем крупнее покупка, тем дешевле в ней каждый токен. Докупка стоит столько, сколько стоит покупка её размера, — ни остаток, ни план на цену не влияют.

**Минимальная покупка** — что первая, что докупка — **30 миллионов токенов**.

На карточке пакета на экране баланса две кнопки:

:::deflist
| Кнопка | Что делает |
| --- | --- |
| Докупить | Открывает покупку любого объёма от минимума — он добавится к остатку. |
| Пополнить до плана | Сразу предлагает объём, который вернёт остаток к плану, — но не меньше минимальной покупки. |
:::

Пока вы не ушли на страницу оплаты, ничего не списано. Лимит пополняется, когда платёж зачислен.

> [Как проходит платёж →](/ru/billing) [Прайс-лист](https://kumorouter.com/ru/pricing)

## Как тратится пакет {#burn keywords="пакет, лимит, минимальная покупка, input, output, кеш, reasoning"}

У аккаунта **один пакет**, и его тратит каждый ключ аккаунта, работающий из пакета. Остаток пакета показан как **лимит в процентах** от плана — не как число токенов и не как формула, которую нужно пересчитывать самому.

У разных моделей **разные цены**, и запрос к более дорогой модели забирает из пакета больше, чем такой же запрос к дешёвой. Цены моделей показаны в консоли и в каталоге.

**Input — это всё, что уходит в модель:** системный промпт, история сообщений, описания инструментов, приложенные файлы, а также всё прочитанное из кеша и записанное в кеш. **Output — это всё, что модель сгенерировала**, включая reasoning-токены, даже если вы их не видите в ответе. Оба входят в то, что тратит пакет за запрос.

Количества токенов и собственный лимит пакета — разные величины, и консоль печатает их порознь: количества, которыми запрос ушёл к модели, видны на экране активности и в развёрнутой карточке вызова, а остаток лимита пакета — в процентах на экране баланса. В одно число они не складываются нигде.

Практический вывод: длинная история диалога — это input, который оплачивается заново на каждом запросе. В агентных сценариях именно она обычно и составляет основную часть расхода, а не ответы модели.

## Какие ключи тратят пакет {#keys keywords="ключ, пакет, баланс, после пакета, лимиты ключа, способ списания"}

Каждый ключ сам выбирает, из чего тратить: **из пакета** или **с баланса**. Выбор не окончательный — его меняют в любой момент в окне «Выбор способа списания», которое открывается нажатием на ячейку ключа в колонке «Списание» на экране ключей (строка «Тратит из»).

Для ключа, который тратит из пакета, в том же окне задаётся, что делать, когда лимит пакета кончится (строка «После пакета»):

:::deflist
| Выбор | Что происходит, когда лимит исчерпан |
| --- | --- |
| стоп | Ключ отклоняет запросы, пока вы не пополните пакет. |
| баланс | Ключ продолжает работать с баланса — по ценам кошелька. |
:::

Пока вы ничего не выбрали, ключ тратит из пакета, если пакет у аккаунта есть, и останавливается, когда лимит кончится; без пакета ключ тратит с баланса.

Каждому ключу можно задать и **свои лимиты пакета**: сколько он вправе потратить из пакета за день, за месяц и за всё время. Пустое поле — лимита нет. Так один прожорливый агент не съест пакет, на который рассчитывают остальные ключи.

Проект на это не влияет: он ярлык над ключами, а не источник денег.

> [Ключи →](/ru/keys) [Как считает кошелёк →](/ru/billing)

## Заморозка {#freeze keywords="заморозка, пауза, пакет, 403"}

Пакет можно **заморозить** переключателем в окне «Детали →» на карточке пакета. Пока пакет заморожен, ключи, которые тратят из пакета, отклоняют запросы с кодом **`403`** `package_frozen` — и на баланс при этом **не** переходят, даже если для них выбрано «после пакета — баланс». Остаток пакета не тратится и никуда не девается.

Снимается заморозка тем же переключателем. Ключей, которые тратят с баланса, заморозка не касается.

Эта заморозка — ваша. Её не надо путать с заморозкой со стороны Kumo после долгого перерыва в покупках: ту этот переключатель не снимает, её снимает покупка.

## Уведомления {#notices keywords="уведомления, 20 %, исчерпан, остаток"}

Консоль сама напоминает о пакете в окне уведомлений дважды: когда в пакете осталось **меньше 20 %** плана и когда **лимит исчерпан**. Если пополнить пакет выше порога и снова его потратить, напоминание придёт снова.

## Когда лимит кончился {#exhausted keywords="402, исчерпан, отказ, стоп, баланс"}

Что будет с запросом, решает выбор ключа «После пакета».

- **стоп** — запрос отклоняется с **`402`** и кодом `insufficient_package_balance`, отдельным от кошелькового: лечится он покупкой пакета, а не пополнением баланса.
- **баланс** — запрос проходит и оплачивается с баланса по ценам кошелька. Если и на балансе пусто, отказ будет кошельковым: `402` `insufficient_wallet_balance`.

Запрос, начатый при живом остатке, в процессе может потратить больше, чем в пакете оставалось. У ключа со «стоп» этот перерасход с баланса **не списывается** — его берёт на себя Kumo.

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

> [Все статусы шлюза →](/ru/errors)

## Срок и возврат {#expiry keywords="срок, три месяца, заморозка остатка, возврат, остаток"}

Остаток пакета **не сгорает автоматически**. Но если по пакету **около трёх месяцев не было покупок**, Kumo вправе **заморозить** его неизрасходованный остаток. Это решение Kumo, а не таймер. Остаток при этом остаётся за аккаунтом, но пока он заморожен, ключи, которые тратят из пакета, отклоняют запросы с кодом **`403`** `package_frozen`.

Эту заморозку не снимает переключатель в окне «Детали →» — её снимает **следующая покупка**: она размораживает остаток. **Каждая покупка отсчитывает этот срок заново.**

Стоимость пакета, в том числе неизрасходованного остатка, **не возвращается**. Денежный баланс кошелька под это правило не подпадает. Точные условия — в [публичной оферте](https://kumorouter.com/ru/legal).

## Цена пакета в рублях {#roubles keywords="рубли, курс, цена пакета, округление, оплата"}

Цена пакета назначена **в долларах**: ёмкость платформа закупает у поставщиков за доллары, и от курса рубля долларовая цена не зависит.

Рублёвая цифра на витрине — этот же доллар, пересчитанный по **учётному курсу** Банка России. Она для ориентира.

Списывается другая: её считает **курс платежа**, закреплённый в момент создания платежа, и она поднята вверх до ближайших десяти рублей. Окно покупки показывает её до перехода на страницу платёжной системы — в счёт уходит именно эта сумма.

Поэтому рубли на витрине и рубли в окне покупки могут отличаться, и разойтись они могут в любую сторону: курсы разные и меняются день ото дня. Долларовая цена пакета при этом одна и та же.

Отличить одно от другого можно по знаку: рублёвая цифра со знаком **≈** — это пересчёт, без знака — сумма, которую спишут. Поэтому на витрине знак стоит у всех рублёвых цифр, а в кабинете — только у строк, из которых складывается цена: сама цена и строка «К оплате» идут без него.

> [Про оба курса →](/ru/billing)

## Пакет или кошелёк {#compare keywords="сравнение, кошелёк, пакет, выбор"}

:::matrix
| | Кошелёк | Пакет |
| --- | --- | --- |
| Что показано | доллары | лимит в процентах от плана |
| Чем пополняется | любой суммой | покупкой от 30 миллионов токенов по лестнице цен |
| Сколько на аккаунт | один | один |
| Правило списания | цена за единицу каждого измерения | ставка Kumo для модели, из лимита пакета |
| Отказ при нехватке | `402` `insufficient_wallet_balance` | `402` `insufficient_package_balance` |
:::

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

> [Прайс-лист](https://kumorouter.com/ru/pricing) [Где смотреть расход →](/ru/usage)