Для AI-агентов: markdown этой страницы — /docs-content/cowork.md индекс документации — /llms.txt

Подписка Коворк/Код

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

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

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

Что такое Коворк/Код

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

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

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

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

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

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

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

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

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

Окно Назначение
Окно5 часов Назначениеограничение кратковременных всплесков
ОкноНеделя Назначениесреднесрочный лимит
ОкноМесяц Назначениесовпадает с расчётным периодом подписки

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

Тарифы

Тариф Множитель Объём квоты
ТарифFree Множитель— Объём квотыбазовая квота, активна сразу
ТарифPro Множитель×1 Объём квотыбазовый платный объём
ТарифMax Множитель×5 Объём квотыв пять раз больше объёма, чем Pro
ТарифUltra Множитель×20 Объём квотыв двадцать раз больше объёма, чем Pro

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

Как начать

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

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

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

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

Terminal
curl https://vibecode.bitrix24.tech/v1/cowork/state \
  -H "X-Api-Key: YOUR_API_KEY"
JSON
{
  "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" } }
}

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

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

javascript
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()

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

Метод Путь Описание
МетодGET Путь/v1/cowork/state ОписаниеПолное состояние: окна квоты, рекомендация, каталог тарифов
МетодGET Путь/v1/cowork/me ОписаниеКраткая сводка: тариф, состояние, проценты квоты
МетодGET Путь/v1/cowork/subscription/preview ОписаниеПредрасчёт: сколько спишется прямо сейчас при переходе на указанный тариф
МетодPOST Путь/v1/cowork/subscription/resume ОписаниеСнятие запланированной отмены подписки: автопродление возвращается, ничего не списывается
МетодGET Путь/v1/cowork/applications/defaults ОписаниеПараметры мастера создания приложения: наборы прав, режим ключа, квота, параметры сервера
МетодPOST Путь/v1/cowork/applications ОписаниеСоздание личного приложения вместе с его ключом
МетодPOST Путь/v1/cowork/applications/:id/key ОписаниеВыдача ключа в пустой слот приложения или замена выданного, ключ участника команды разработки
МетодPOST Путь/v1/cowork/deploy-key ОписаниеПроектный ключ с правом деплоя (скоупы vibe:infra + vibe:storage, 7 дней)

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

Коды ошибок

HTTP Код Описание
HTTP401 КодMISSING_API_KEY ОписаниеНе передан заголовок X-Api-Key
HTTP401 КодINVALID_API_KEY ОписаниеКлюч не опознан: такой строки на платформе нет
HTTP403 КодINSUFFICIENT_SCOPE ОписаниеУ ключа нет скоупа vibe:cowork
HTTP404 КодCOWORK_NOT_ACTIVATED ОписаниеПодписка Коворк/Код не найдена для пары пользователь и портал
HTTP500 КодINVALID_TIER_CONFIGURATION ОписаниеКонфигурация тарифов на платформе некорректна
HTTP503 КодCOWORK_FEATURE_DISABLED ОписаниеКоворк/Код отключён на уровне платформы
HTTP503 КодAPP_CREATE_DISABLED ОписаниеСоздание приложений из Коворк/Код отключено на уровне платформы

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

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