Для AI-агентов: markdown этой страницы — /docs-content/ai/pricing.md индекс документации — /llms.txt
Стоимость AI-запросов
Из чего складывается цена вызова модели, чем он оплачивается и какие отказы приходят, когда оплатить вызов нечем.
Действующие цены моделей и израсходованную долю квоты возвращают эндпоинты, перечисленные ниже.
Цены моделей
Цену каждой модели возвращает GET /v1/models в объекте pricing, цену одной модели — GET /v1/models/:modelId. Все цены указаны в Вайбах — внутренней валюте платформы.
| Поле | Что тарифицирует |
|---|---|
Полеpricing.prompt |
Что тарифицирует1 миллион токенов входа |
Полеpricing.completion |
Что тарифицирует1 миллион токенов ответа |
Полеpricing.perMinute |
Что тарифицируетМинуту аудио. Приходит только когда больше 0 |
Полеpricing.perCall |
Что тарифицируетОдин вызов. Приходит только когда больше 0 |
Полеpricing.unit |
Что тарифицируетЕдиница измерения, всегда vibes |
Модель распознавания речи тарифицируется по perMinute и perCall, а её prompt и completion равны 0. Поэтому нулевые prompt и completion ещё не означают, что вызов бесплатный: смотрите все поля pricing.
Чем оплачивается вызов
| Ключ и модель | Чем оплачивается |
|---|---|
| Ключ и модельМодель платформы, обычный API-ключ | Чем оплачиваетсяМесячной AI-квотой компании, если модель входит в программу квоты. Сверх квоты, если такой расход для портала разрешён, — с баланса портала по цене модели из каталога. Модель вне программы квоты оплачивается с баланса портала по цене из каталога |
Ключ и модельМодель платформы, ключ подписки Cowork/Code со скоупом vibe:cowork |
Чем оплачиваетсяКвотой подписки Cowork/Code, пока подписка подключена и активна. Месячную AI-квоту компании такой вызов не расходует |
| Ключ и модельМодель на вашем личном ключе провайдера (BYOK) | Чем оплачиваетсяНапрямую провайдеру по его тарифам. С баланса портала ничего не списывается |
Личный ключ провайдера подключается через POST /v1/ai/credentials, подробнее — в разделе Свои ключи (BYOK).
Месячная AI-квота компании
Квота общая для всего портала, а не для отдельного ключа: её расходуют все API-ключи компании. Абсолютный размер квоты в Вайбах API не раскрывает. GET /v1/ai/quota показывает израсходованную долю в процентах, дату сброса и разбивку по моделям.
Квоту расходуют только модели, включённые в программу квоты. Вызовы остальных моделей видны в разбивке со счётчиком запросов, но их доля квоты равна 0.
Когда квота исчерпана, а расход сверх неё оплатить нечем, вызов отклоняется 402 ai_quota_exhausted. Поле reason называет причину: breaker — сработал часовой предохранитель расхода сверх квоты, wallet_empty — на балансе портала нет средств, wallet_off — расход сверх квоты для портала недоступен.
Равномерное расходование и выгодные часы
Кроме месячного лимита на портале могут действовать суточное и недельное окна — доли месячной квоты, которые нельзя превысить за сутки и за неделю. Они не уменьшают квоту, а растягивают её расход на месяц. Состояние окон приходит в поле pacing ответа GET /v1/ai/quota, там же описаны режимы реакции на превышение окна. Когда окно пробито и вызов не может пройти как оплачиваемое превышение, он отклоняется 429 ai_pacing_limited.
В выгодные часы один и тот же вызов забирает меньшую долю квоты. Расписание по часам недели возвращает GET /v1/off-peak. Скидка действует только на расход квоты: оплата с баланса портала по цене модели скидку не получает. Перенос отложенных задач в выгодные часы отдаляет и исчерпание месячной квоты, и срабатывание суточного или недельного окна.
Подписка Cowork/Code
Подписка даёт одну квоту на AI-запросы, которую расходуют вместе настольное приложение Cowork, режим Code и автономные AI-агенты. Отдельных лимитов у этих инструментов нет: вызовы агента и сессии в настольном приложении тратят один общий баланс. Расход считается в трёх вложенных окнах — 5 часов, неделя и месяц. Тарифы и окна описаны в разделе Подписка Cowork/Code.
Квота подписки покрывает только AI-запросы и только пока подписка подключена и активна. Собственный сервер, на котором работает AI-агент, оплачивается из кошелька портала отдельно.
Когда одно из окон исчерпано, вызов отвечает 402 cowork_quota_exhausted. Если на платформе настроена резервная модель, вместо отказа может прийти 200 с сообщением о лимите, а сам запрос не выполняется — подробнее в POST /v1/chat/completions. Тело отказа называет окно в поле window, время сброса в resetAt и тариф выше в nextTier.
Отказы из-за оплаты
| HTTP | Код | Когда приходит |
|---|---|---|
| HTTP402 | Кодai_quota_exhausted |
Когда приходитМесячная AI-квота компании исчерпана, а расход сверх неё оплатить нечем |
| HTTP402 | Кодcowork_quota_exhausted |
Когда приходитИсчерпано одно из окон квоты подписки Cowork/Code |
| HTTP402 | Кодcowork_subscription_inactive |
Когда приходитУ ключа со скоупом vibe:cowork нет действующей подписки Cowork/Code |
| HTTP402 | Кодcompany_budget_exhausted |
Когда приходитИсчерпан бюджет расхода, который задал администратор портала. Приходит только на вызовах, которые списывают средства с баланса портала |
| HTTP402 | Кодaccount_frozen |
Когда приходитПлатёжный аккаунт заморожен из-за отрицательного баланса |
| HTTP429 | Кодai_pacing_limited |
Когда приходитПробито суточное или недельное окно равномерного расходования, а оплачиваемое превышение недоступно |
Полный список общих ошибок API — Ошибки.
Поля каждого ответа и порядок действий описаны в таблице ошибок POST /v1/chat/completions. Ограничения частоты запросов к моделям не связаны с оплатой и описаны на странице Лимиты запросов.
Известные особенности
Снятая с публикации модель тарифицируется по цене преемника. Если вызов модели в состоянии DISABLED обслужила модель-преемник, списание идёт по цене преемника, и pricing в ответе GET /v1/models/:modelId показывает именно её. Подробнее — Жизненный цикл моделей.
Токены рассуждения оплачиваются как токены ответа. У моделей с рассуждением эти токены входят в usage.completion_tokens и тарифицируются по ставке pricing.completion.
Проверяйте квоту до массовой обработки. Поля pctUsed и exhausted в ответе GET /v1/ai/quota позволяют предупредить пользователя заранее, а не дожидаться отказа 402.