Vibe API - это REST-интерфейс поверх Битрикс24, заточенный под работу с ИИ-агентами: 300+ методов, авто-пагинация, батчинг и встроенный роутер моделей с бесплатными BitrixGPT, Whisper и Vision. Разбираем архитектуру, возможности BYOK и практические сценарии применения.
Если вы уже работали с «сырым» REST Битрикс24, вы знаете цену ручной пагинации, ошибок 429/503 и постоянного маппинга UPPER_CASE-полей в читаемые имена. Vibe API решает всё это на уровне платформы - и добавляет встроенный роутер ИИ-моделей с бесплатными опциями.
Vibe API - слой REST поверх стандартного Битрикс24 REST, созданный специально для ИИ-агентов и вайбкодинга. Там, где обычный REST требует от разработчика вручную обрабатывать лимиты, пагинацию и трансформацию полей, Vibe API берёт это на себя.
Платформа Вайбкод закрывает четыре слоя, которые раньше приходилось собирать вручную: удобный API к Битрикс24, встроенные ИИ-модели, хостинг на серверах Black Hole и готовые ИИ-агенты для портала.
Путь запроса от ИИ-агента до данных Битрикс24 через Vibe API: агент отправляет запрос в единую точку входа, платформа берёт на себя очередь, батчинг и пагинацию, а затем возвращает трансформированный ответ.
flowchart TD
AGENT[ИИ-агент / Claude / Codex] -->|REST запрос| VAPI[Vibe API]
VAPI -->|batch / queue| B24[Битрикс24 REST]
B24 -->|UPPER_CASE ответ| VAPI
VAPI -->|camelCase ответ| AGENT
VAPI -->|OpenAI-совместимый| ROUTER[AI Model Router]
ROUTER --> BGPT[BitrixGPT / Whisper / Vision]
ROUTER --> BYOK[Свои ключи BYOK]
Vibe API предоставляет 300+ методов в виде entity-обёрток - это не прямые проксирующие вызовы, а трансформирующий слой с дополнительной логикой.
Что входит в покрытие (на момент публикации):
Покрытие постоянно расширяется: новую обёртку для метода, которой не хватает, команда добавляет «за день» по запросу сообщества.
| Функция | Как работает |
|---|---|
| Маппинг полей | camelCase в запросах ↔ UPPER_CASE в ответах Битрикс24 |
| Авто-пагинация | limit до 5 000, date windowing для больших диапазонов |
| Батчинг | собирает >50 операций в один пакет |
| Очередь запросов | соблюдает лимиты Битрикс24 без ошибок 503/429 |
| Фильтры | MongoDB-синтаксис: { closedAt: { $gte, $lte }, stageSemanticId: "F" } |
| CRUD пользовательских полей | для сделок, лидов, контактов, компаний, КП - без отдельного вебхука |
| Обработка ошибок | трансформация и ретрай на уровне платформы |
Важное ограничение: универсального
POST /v1/callнет - он убран намеренно в пользу entity-обёрток, которые обеспечивают трансформацию полей, пагинацию и обработку ошибок.
GET /v1/me - ключ сам описывает свои возможности и доступные API. Это нужно модели, чтобы «перечитать доку» и писать корректный код. Через MCP доступна команда discover - схема из 66 сущностей. Документация Vibe API написана для моделей, а не для людей.
Для выгрузки десятков сущностей без пагинации, без лимита частоты, до 10 млн строк удобнее API BI-коннектора Битрикс24 - ключ находится в личном кабинете «Аналитика Битрикс24». Для ИИ-ассистента, работающего с большими данными, это нередко проще, чем REST.
Платформа предоставляет AI Model Router: единый эндпоинт, единый формат (OpenAI-совместимый), один ключ. Раньше нужно было самостоятельно регистрироваться у провайдера и разбираться с форматами - теперь всё встроено.
curl -X POST https://vibecode.bitrix24.tech/v1/ai/chat/completions \
-H "X-Api-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"messages":[{"role":"user","content":"Привет!"}]}'
Без указания параметра model подключается бесплатная BitrixGPT 5.
Все модели серии BitrixGPT размещены на серверах в России - это важно для компаний с требованиями к локализации данных. Доступны без дополнительной оплаты при наличии активной подписки Вайбкод (на момент публикации).
| Модель | Идентификатор (примерный) | Назначение |
|---|---|---|
| BitrixGPT 5 | bitrix/gpt-5 |
Базовая текстовая модель |
| BitrixGPT 5.5 | bitrix/gpt-5.5 |
Улучшенная текстовая модель |
| BitrixGPT 5.5 Agent | bitrix/gpt-5.5-agent |
Агентные сценарии, инструменты |
| Vision | bitrix/vision-* |
Анализ изображений |
| Whisper | bitrix/deepdml/faster-whisper-large-v3-turbo-ct2 |
Речь → текст |
| GPT-OSS | bitrix/openai/gpt-oss-120b |
OSS-модель от OpenAI |
| Gemma | bitrix/google/gemma-4-26B-A4B-it / -thinking |
Google Gemma, включая thinking |
| Kimi | bitrix/moonshotai/Kimi-K2.5 |
Модель Moonshot AI |
Идентификаторы моделей и их параметры могут меняться. Актуальный список - в документации
https://vibecode.bitrix24.tech/docs.
Модель Vision принимает изображения и возвращает структурированный текст. Практические применения:
При работе с Vision важно следить за mime-типом и размером изображения: ошибка invalid_image_payload (400) означает проблему с форматом или конкретным индексом парта.
Whisper (идентификатор bitrix/deepdml/faster-whisper-large-v3-turbo-ct2) - модель транскрибации, работающая в инфраструктуре Битрикс24. Аудио не уходит к сторонним провайдерам вроде OpenAI, но контур здесь вендорский, а не ваш: файл всё равно передаётся на обработку наружу.
Типичные сценарии:
Подробнее об ИИ-анализе звонков, включая скоринг качества, - в статье «AI-анализ звонков в Битрикс24».
BYOK (Bring Your Own Key) - механизм, позволяющий использовать собственные ключи провайдеров через единый API Вайбкод. Формат запроса остаётся OpenAI-совместимым; роутер платформы сам транслирует вызов к нужному провайдеру.
Поддерживаемые провайдеры (на момент публикации):
openai/gpt-4o-miniЧек-лист: когда нужен BYOK
При BYOK стоимость токенов списывается с вашего аккаунта провайдера, а не с баланса вайбов. Инфраструктура хостинга и роутинга при этом остаётся на стороне Вайбкода.
Пакет @vibe/mcp-vibe-api - MCP-сервер, позволяющий ИИ-агенту вызывать Vibe API напрямую как инструмент, без ручного подтверждения каждого curl-вызова. Это критично для масштабирования агентных сценариев.
Что включает MCP (25 инструментов):
discover - схема API для 66 сущностейПодключение через конфигурацию:
{
"mcpServers": {
"vibe-api": {
"command": "npx",
"args": ["@vibe/mcp-vibe-api", "--key", "vibe_live_..."]
}
}
}
Поддерживаются режимы stdio и HTTP (флаг --http --port 3001). О применении ИИ-агентов в Битрикс24 подробнее - в статье «ИИ-агенты Hermes и Коворк/Код».
Вайбкод и Vibe API подключаются не только к облаку, но и к коробочной (on-premise) версии Битрикс24.
Важная оговорка: сами модели остаются облачными. Портал, база и файлы лежат на сервере компании, а вызовы ИИ-агентов, транскрибации Whisper и анализа изображений через Vision уходят по HTTPS на серверы вендора. Коробке нужен исходящий доступ в интернет: в полностью закрытом контуре ИИ-инструменты Битрикс24 не работают ни через Vibe API, ни из интерфейса портала.
О безопасности вайбкодинга при работе с корпоративными данными - в статье «Безопасность вайбкодинга в Битрикс24».
Зная коды ошибок заранее, можно сократить время отладки:
| Код | Значение |
|---|---|
WRITE_BLOCKED_READONLY_KEY |
Запись заблокирована read-only ключом |
invalid_image_payload (400) |
Проблема с картинкой для Vision (mime/размер/индекс парта) |
RATE_LIMIT, BITRIX_UNAVAILABLE |
Временные, поддаются повтору |
PROVIDER_ERROR |
Ошибка на стороне провайдера модели (актуально при BYOK) |
DEPLOY_FAILED |
Healthcheck не прошёл (приложение не ответило 200) |
TRIAL_PORTAL_LIMIT |
Лимит серверов на триал-портале (1/1) |
Платформа поддерживает автоматический фидбэк: при неожиданной ошибке ИИ-агент может сам отправить тикет через POST /v1/feedback - тикет получает номер VB-XXXXXXXX, и команда платформы получает уведомление.
Для разработчика, который уже умеет работать с REST Битрикс24, важно понять: Vibe API не заменяет REST полностью, но снимает значительную часть рутины.
| Параметр | Прямой REST Битрикс24 | Vibe API |
|---|---|---|
| Пагинация | Ручная (start, next) | Авто (limit до 5 000) |
| Маппинг полей | Вручную | Авто camelCase ↔ UPPER_CASE |
| Rate-limit | Ручной retry | Очередь и батчинг платформы |
| Фильтры | Битрикс-синтаксис | MongoDB-синтаксис |
| ИИ-роутер | Нет | Встроен |
| Самоописание | Нет | GET /v1/me |
| Документация | Для людей | Для моделей |
| Пользовательские поля | Отдельные вебхуки | CRUD из коробки |
Для интеграции Битрикс24 и 1С или других систем с большим объёмом данных прямой REST может быть более предсказуем - но для задач с ИИ-агентами Vibe API экономит десятки часов разработки.
АС Проект - Платиновый партнёр Битрикс24. Если вы планируете внедрить ИИ-инструменты Вайбкод, настроить BYOK или собрать приложение на Vibe API - мы помогаем на всех этапах: от выбора архитектуры до запуска в рабочей среде.
Vibe API даёт три высокоценные возможности, все в российском контуре:
📞 Готовые расшифровки звонков. GET /v1/activities/:activityId/transcript (право доступа crm, включён BitrixGPT для звонков) - забирает готовый текст расшифровки без повторной транскрибации.
📚 База знаний 2.0 через API. Право доступа note, поиск GET /v1/note/documents/search - создание, наполнение и поиск по документам базы знаний портала прямо из кода. Документация: vibecode.bitrix24.tech/docs/note.
🧠 Векторные эмбеддинги. Модель bitrix/embeddings (POST /v1/embeddings, право доступа vibe:ai) - бесплатная, OpenAI-совместимая, превращает любой текст в вектор. Массив строк в input → массив векторов за один запрос. Для семантического поиска, «похожих сущностей», RAG-ассистентов и дедупликации. Документация: vibecode.bitrix24.tech/docs/ai/embeddings.
Модели: добавлена «думающая» bitrix/bitrixgpt-5.5-thinking (по умолчанию не включена для Коворк/Код). Для агентов лучше фиксировать bitrix/bitrixgpt-5.5-agent, а не авто-роутер bitrix/agent/auto (может выбрать недоступную модель → ошибка 402).
Важно (Pricing v2): с июля 2026 бесплатные модели бесплатны в пределах ИИ-квоты по тарифу, сверх квоты - оплата с баланса вайбов.
Нужна помощь по вайбкод-приложению? АС Проект - платиновый партнёр Битрикс24: собираем приложения на Вайбкоде, проверяем чужие перед боевым запуском и берём на сопровождение. Состав работ и цены - на странице приложения на вайбкодинге.
discover отдаёт 66 сущностей Битрикс24, всего в API более 1 600 методов. Отдельно работает бот-платформа./v1/off-peak.Данные на 29 августа 2026 - платформа Вайбкод в активной бете, цифры (квоты, цены, версии) меняются. Сверяйтесь с документацией Вайбкода.
Оставьте заявку - мы свяжемся с вами и проконсультируем.
Эксперт АС Проект свяжется в течение 60 минут.