#Подписка Cowork

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

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

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

#Что такое Cowork

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

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

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

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

Агенты и режим Code расходуют ту же квоту автоматически — отдельно настраивать ничего не нужно.

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

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

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

#Тарифы

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

#Как начать

1. Откройте раздел Cowork в личном кабинете.
2. Бесплатный тариф активен сразу — квота доступна без подключения.
3. Нужно больше квоты — выберите тариф Start, Pro или Max.
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": "START" } }
}

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

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

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:', 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 — Ошибки.

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

• Эндпоинты
• Ключи и авторизация
• Лимиты и оптимизация
• Ошибки