Для 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 (в Вайбах за месяц), и актуальна на момент запроса.
Как начать
- Откройте раздел Коворк/Код в личном кабинете.
- Бесплатный тариф активен сразу — квота доступна без подключения.
- Нужно больше квоты — выберите тариф Pro, Max или Ultra.
- Для вызова эндпоинтов этого раздела используйте ключ авторизации со скоупом
vibe:cowork— передавайте его в заголовкеX-Api-Key. - Агенты и режим 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()
Справочник эндпоинтов
| Метод | Путь | Описание |
|---|---|---|
| Метод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 — Ошибки.