Подписка Cowork/Code

Cowork/Code — это единая подписка: настольное приложение, режим Code и автономные агенты делят одну квоту на искусственный интеллект (AI). Эндпоинты раздела показывают текущее состояние подписки — тариф, расход квоты по трём окнам в процентах и рекомендации, когда подождать сброса или перейти на тариф выше. Подписка покрывает только AI и только пока она подключена и активна: собственный сервер, на котором работает AI-агент, оплачивается отдельно, из кошелька портала. Кроме чтения состояния раздел выдаёт проектный ключ с правом деплоя и создаёт личное приложение вместе с его ключом.

Скоуп: vibe:cowork | Базовый URL: https://vibecode.bitrix24.tech/v1 | Авторизация: X-Api-Key

Три окна квоты | Тарифы | Как начать | Быстрый старт | Полный пример | Справочник эндпоинтов | Коды ошибок | Свой агент

Что такое Cowork/Code

Одна подписка даёт одну квоту на AI-запросы — её тратят три инструмента из общего баланса:

• Cowork — настольное приложение с AI-ассистентом для работы с порталом Битрикс24.
• Code — режим написания и публикации приложений внутри настольного приложения.
• AI Agent — автономные AI-агенты.

Квота покрывает только AI и только пока подписка подключена и активна. Собственный сервер, на котором работает AI-агент, оплачивается из кошелька портала отдельно.

Преимущества единой подписки:

• Общий баланс на три инструмента вместо отдельных лимитов.
• Бесплатный тариф активен сразу — оплата не требуется, чтобы начать.
• Расход показан в процентах, перерасхода нет — лимит предсказуем.
• Масштабируется тарифами ×1 → ×5 → ×20 под рост задач.

Пока подписка подключена и активна, агенты и режим Code расходуют её квоту автоматически — отдельно настраивать ничего не нужно. Собственный сервер AI-агента при этом оплачивается из кошелька портала и в квоту подписки не входит.

Отключение Cowork/Code на уровне платформы не меняет тарификацию AI-запросов уже выданного ключа vibe:cowork: чат и расшифровка аудио продолжают расходовать квоту активной подписки. Для аудио также нужна назначенная администратором цена за минуту или за вызов для доступной вам модели. Без активной подписки аудио сохраняет обычный путь тарификации без списания квоты подписки.

Три окна квоты

Расход квоты считается одновременно в трёх вложенных окнах:

Работа блокируется при исчерпании любого из окон. У каждого окна есть процент использования и время сброса. Абсолютные числа квоты наружу не отдаются — и /v1/cowork/state, и /v1/cowork/me показывают только проценты.

Тарифы

Множитель ×N задаёт объём квоты во всех трёх окнах относительно тарифа Pro (×1). Стоимость каждого тарифа приходит отдельно, в поле feeVibes (в Вайбах за месяц), и актуальна на момент запроса.

Как начать

1. Откройте раздел Cowork/Code в личном кабинете.
2. Бесплатный тариф активен сразу — квота доступна без подключения.
3. Нужно больше квоты — выберите тариф Pro, Max или Ultra.
4. Для вызова эндпоинтов этого раздела используйте ключ авторизации со скоупом vibe:cowork — передавайте его в заголовке X-Api-Key.
5. Агенты и режим Code используют квоту этой подписки автоматически, пока она подключена и активна.

Подробнее о ключах и скоупах — Ключи и авторизация.

Быстрый старт

Текущее состояние подписки одним запросом:

curl https://vibecode.bitrix24.tech/v1/cowork/state \
  -H "X-Api-Key: YOUR_API_KEY"

{
  "subscription": { "tier": "FREE", "state": "ACTIVE", "nextChargeAt": null, "cancelAtPeriodEnd": false },
  "windows": {
    "fiveHour": { "pctUsed": 40, "resetAt": "2026-06-09T17:30:00.000Z", "exhausted": false },
    "week":     { "pctUsed": 24, "resetAt": "2026-06-12T09:00:00.000Z", "exhausted": false },
    "month":    { "pctUsed": 20, "resetAt": "2026-07-01T00:00:00.000Z", "exhausted": false }
  },
  "bottleneck": "fiveHour",
  "recommendation": { "reason": "none", "upgrade": { "available": true, "nextTier": "PRO" } }
}

Полный пример: слежение за квотой

Скрипт опрашивает состояние подписки и реагирует на приближение к лимиту и на исчерпание квоты.

const BASE = 'https://vibecode.bitrix24.tech/v1'
const API_KEY = process.env.VIBE_KEY

async function checkQuota() {
  const res = await fetch(`${BASE}/cowork/state`, {
    headers: { 'X-Api-Key': API_KEY },
  })

  if (!res.ok) {
    const { error } = await res.json()
    console.error('Cowork/Code:', error.code, error.message)
    return
  }

  const state = await res.json()
  const { windows, bottleneck, recommendation } = state

  // Самое нагруженное окно
  const tight = windows[bottleneck]
  console.log(`Окно ${bottleneck}: ${tight.pctUsed}%`)

  // Квота исчерпана — показываем, когда снова можно работать
  if (recommendation.wait) {
    const seconds = Math.ceil((new Date(recommendation.wait.resetAt) - new Date(state.serverTime)) / 1000)
    console.log(`Лимит исчерпан, сброс через ${seconds} с`)
  }

  // Приближение к лимиту — предлагаем тариф выше
  if (recommendation.reason === 'approaching' && recommendation.upgrade.nextTier) {
    console.log(`Стоит перейти на тариф ${recommendation.upgrade.nextTier}`)
  }
}

// Опрос раз в 30 секунд
setInterval(checkQuota, 30_000)
checkQuota()

Справочник эндпоинтов

Интерактивный переключатель методов с примерами и полями ответа — Эндпоинты.

Коды ошибок

Полный список общих ошибок API — Ошибки.

Смотрите также

• Эндпоинты
• Выгодные часы в подписке Cowork/Code
• Ключи и авторизация
• Лимиты и оптимизация
• Ошибки