Пакеты
Один пакет на аккаунт: лимит в процентах от плана, докупка и минимальная покупка, какие ключи тратят пакет, заморозка, уведомления и чем пакет отличается от кошелька.
Что такое пакет
Пакет — это предоплаченный лимит токенов, купленный заранее со скидкой по объёму. Он тратится токенами, а не деньгами, и кошелёк сам по себе не трогает.
Пакет у аккаунта один. Первая покупка его открывает, каждая следующая — пополняет тот же пакет. Выбирать, куда зачислить покупку, не нужно: зачислять больше некуда.
Тратит пакет любой ключ аккаунта, которому вы разрешили тратить из пакета, — а какие это ключи, решаете вы, ключ за ключом.
План и лимит
План — это самая крупная разовая покупка пакета. По нему консоль называет группу пакета — Pro, Max или Ultra — и от него же отсчитывает остаток. Покупка меньше плана план не понижает; покупка крупнее — поднимает его до себя. Никаких привилегий к плану не прилагается: это только мерка, от которой считается шкала.
Остаток пакета показан как лимит в процентах от плана: сколько из плана ещё можно потратить. Если остаток после пополнения больше плана, шкала стоит на 100 %. Цвет шкалы меняется, когда остаток опускается ниже половины и ниже 20 %.
Покупка и пополнение
Цена покупки считается по размеру самой этой покупки на опубликованной лестнице цен: чем крупнее покупка, тем дешевле в ней каждый токен. Докупка стоит столько, сколько стоит покупка её размера, — ни остаток, ни план на цену не влияют.
Минимальная покупка — что первая, что докупка — 30 миллионов токенов.
На карточке пакета на экране баланса две кнопки:
Пока вы не ушли на страницу оплаты, ничего не списано. Лимит пополняется, когда платёж зачислен.
Как проходит платёж → Прайс-лист
Как тратится пакет
У аккаунта один пакет, и его тратит каждый ключ аккаунта, работающий из пакета. Остаток пакета показан как лимит в процентах от плана — не как число токенов и не как формула, которую нужно пересчитывать самому.
У разных моделей разные цены, и запрос к более дорогой модели забирает из пакета больше, чем такой же запрос к дешёвой. Цены моделей показаны в консоли и в каталоге.
Input — это всё, что уходит в модель: системный промпт, история сообщений, описания инструментов, приложенные файлы, а также всё прочитанное из кеша и записанное в кеш. Output — это всё, что модель сгенерировала, включая reasoning-токены, даже если вы их не видите в ответе. Оба входят в то, что тратит пакет за запрос.
Количества токенов и собственный лимит пакета — разные величины, и консоль печатает их порознь: количества, которыми запрос ушёл к модели, видны на экране активности и в развёрнутой карточке вызова, а остаток лимита пакета — в процентах на экране баланса. В одно число они не складываются нигде.
Практический вывод: длинная история диалога — это input, который оплачивается заново на каждом запросе. В агентных сценариях именно она обычно и составляет основную часть расхода, а не ответы модели.
Какие ключи тратят пакет
Каждый ключ сам выбирает, из чего тратить: из пакета или с баланса. Выбор не окончательный — его меняют в любой момент в окне «Выбор способа списания», которое открывается нажатием на ячейку ключа в колонке «Списание» на экране ключей (строка «Тратит из»).
Для ключа, который тратит из пакета, в том же окне задаётся, что делать, когда лимит пакета кончится (строка «После пакета»):
Пока вы ничего не выбрали, ключ тратит из пакета, если пакет у аккаунта есть, и останавливается, когда лимит кончится; без пакета ключ тратит с баланса.
Каждому ключу можно задать и свои лимиты пакета: сколько он вправе потратить из пакета за день, за месяц и за всё время. Пустое поле — лимита нет. Так один прожорливый агент не съест пакет, на который рассчитывают остальные ключи.
Проект на это не влияет: он ярлык над ключами, а не источник денег.
Заморозка
Пакет можно заморозить переключателем в окне «Детали →» на карточке пакета. Пока пакет заморожен, ключи, которые тратят из пакета, отклоняют запросы с кодом `403` package_frozen — и на баланс при этом не переходят, даже если для них выбрано «после пакета — баланс». Остаток пакета не тратится и никуда не девается.
Снимается заморозка тем же переключателем. Ключей, которые тратят с баланса, заморозка не касается.
Эта заморозка — ваша. Её не надо путать с заморозкой со стороны Kumo после долгого перерыва в покупках: ту этот переключатель не снимает, её снимает покупка.
Уведомления
Консоль сама напоминает о пакете в окне уведомлений дважды: когда в пакете осталось меньше 20 % плана и когда лимит исчерпан. Если пополнить пакет выше порога и снова его потратить, напоминание придёт снова.
Когда лимит кончился
Что будет с запросом, решает выбор ключа «После пакета».
- стоп — запрос отклоняется с `402` и кодом
insufficient_package_balance, отдельным от кошелькового: лечится он покупкой пакета, а не пополнением баланса. - баланс — запрос проходит и оплачивается с баланса по ценам кошелька. Если и на балансе пусто, отказ будет кошельковым:
402insufficient_wallet_balance.
Запрос, начатый при живом остатке, в процессе может потратить больше, чем в пакете оставалось. У ключа со «стоп» этот перерасход с баланса не списывается — его берёт на себя Kumo.
Не путайте с областью: вызов, назвавший модель вне белого списка ключа, — это 403, и лечится он другим ключом, а не покупкой.
Срок и возврат
Остаток пакета не сгорает автоматически. Но если по пакету около трёх месяцев не было покупок, Kumo вправе заморозить его неизрасходованный остаток. Это решение Kumo, а не таймер. Остаток при этом остаётся за аккаунтом, но пока он заморожен, ключи, которые тратят из пакета, отклоняют запросы с кодом `403` package_frozen.
Эту заморозку не снимает переключатель в окне «Детали →» — её снимает следующая покупка: она размораживает остаток. Каждая покупка отсчитывает этот срок заново.
Стоимость пакета, в том числе неизрасходованного остатка, не возвращается. Денежный баланс кошелька под это правило не подпадает. Точные условия — в публичной оферте.
Цена пакета в рублях
Цена пакета назначена в долларах: ёмкость платформа закупает у поставщиков за доллары, и от курса рубля долларовая цена не зависит.
Рублёвая цифра на витрине — этот же доллар, пересчитанный по учётному курсу Банка России. Она для ориентира.
Списывается другая: её считает курс платежа, закреплённый в момент создания платежа, и она поднята вверх до ближайших десяти рублей. Окно покупки показывает её до перехода на страницу платёжной системы — в счёт уходит именно эта сумма.
Поэтому рубли на витрине и рубли в окне покупки могут отличаться, и разойтись они могут в любую сторону: курсы разные и меняются день ото дня. Долларовая цена пакета при этом одна и та же.
Отличить одно от другого можно по знаку: рублёвая цифра со знаком ≈ — это пересчёт, без знака — сумма, которую спишут. Поэтому на витрине знак стоит у всех рублёвых цифр, а в кабинете — только у строк, из которых складывается цена: сама цена и строка «К оплате» идут без него.
Пакет или кошелёк
| Кошелёк | Пакет | |
|---|---|---|
| Что показано | доллары | лимит в процентах от плана |
| Чем пополняется | любой суммой | покупкой от 30 миллионов токенов по лестнице цен |
| Сколько на аккаунт | один | один |
| Правило списания | цена за единицу каждого измерения | ставка Kumo для модели, из лимита пакета |
| Отказ при нехватке | 402 insufficient_wallet_balance | 402 insufficient_package_balance |
Совмещать их законно и обычно: часть ключей тратит из пакета, часть — с баланса, а ключ на пакете может продолжить с баланса, когда лимит кончится. Расход каждого ключа виден отдельно — из пакета и с баланса порознь. Сложить их в одно число нельзя: у суммы долларов и токенов пакета нет единицы.