Оплата и сколько это стоит

НачалоНовичок8 мин

Баланс в долларах. Пополняете заранее, за каждый запрос списываются использованные токены. Подписок нет.

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

Способ	Комиссия сверху
СБП (в рублях по курсу)	≈ 8,5%
Криптовалюта	—
Иностранная карта ($2–$594 за платёж)	≈ 13%

Российские карты временно не принимаются — платите через СБП. Итоговая сумма видна до оплаты.

Бонусы: $0.50 за подписку на @zukkopro (один раз на Telegram-аккаунт, забрать в кабинете). 10% с пополнений приглашённых — по реферальной ссылке из кабинета. Стартового бонуса нет.

2Сколько стоит запрос

Стоимость = входные токены × цена входа + выходные × цена выхода. Цены за 1 млн токенов — в Модели и цены. Часть входа из кэша стоит дешевле.

Ориентир: страница русского текста — около 1 000 токенов.

Час работы в Claude Code обычно стоит $0.8–1.6. Как тратить меньше — Как платить меньше.

3Когда запрос не пройдёт

Почта не подтверждена — 403 email_unverified (при входе через Telegram не нужно).
На балансе меньше $0.01 — 402 insufficient_balance.

Списание идёт после ответа, по факту. Длинный запрос может увести баланс в минус — тогда следующие получат 402, а пополнение сначала закроет минус.

4Что бесплатно

Запросы, отклонённые до модели: нет денег, лимит ключа, нет такой модели, неверный ключ.
Ответы с ошибкой.
Ответ из кэша Zukko (X-Zukko-Cache: true) и повтор с тем же Idempotency-Key.
/v1/balance и /v1/usage.

5Что платно, хотя не очевидно

Прерванный стриминг — ответ дочитывается и списывается целиком.
POST /v1/messages/count_tokens — по цене входа.
POST /v1/web-search — как небольшой расход токенов.
Рассуждения «думающих» моделей — это тоже токены.

6Где смотреть расходы

Кабинет → Расходы — каждый запрос с моделью, токенами и ценой.
API: GET /v1/usage и GET /v1/balance.
Заголовок X-Zukko-Cost-Micros в обычном (не потоковом) ответе — цена запроса.

Баланс общий: все ключи, веб-чат и Telegram-бот тратят одни деньги.

Примерно через минуту после запроса стоимость пересчитывается по точным данным о кэше — разница возвращается или досписывается.

7Лимиты на ключ

В кабинете на каждый ключ можно поставить лимит в день и в месяц и список разрешённых моделей.

Ситуация	Ответ
Модели нет в списке ключа	`403 model_not_allowed_for_key`
Кончился дневной лимит	`429 key_daily_limit_reached`
Кончился месячный лимит	`429 key_monthly_limit_reached`

Сброс — в 00:00 UTC и 1-го числа. Пустой лимит или 0 — без ограничений. Последний запрос может немного превысить лимит. Подробнее — Лимиты ключа и кэш.

8Единицы в API

Где	Единица	Пример
`GET /v1/balance` → `balance_cents`	центы, вниз	`1234` = $12.34
`GET /v1/usage` → `cost_cents`	центы с дробью	`0.0525` = $0.000525
`X-Zukko-Cost-Micros`	микродоллары	`525` = $0.000525
`X-Fetch-Balance-Cents`	микродоллары	`12340000` = $12.34
`/api/` кабинета, поля `_cents`	микродоллары	`12340000` = $12.34

Модели и цены

Миграция