Чат-комплишены

Генерация ответа модели через единый OpenAI-совместимый эндпоинт. Поддерживает синхронный режим, потоковую передачу через Server-Sent Events, вызов функций, гарантированный JSON-ответ и работу с изображениями.

Скоуп: vibe:ai

Создать чат-комплишен

Ответ приходит в сыром OpenAI-формате.

Обёртки {success, data}, которая используется в остальных эндпоинтах Вайбкод — /v1/deals, /v1/tasks и других, — здесь нет.

Так сделано для совместимости с OpenAI SDK. Если у вас единый клиент с проверкой if (!response.success), добавьте для AI Router исключение.

POST /v1/chat/completions

Генерирует ответ AI-модели на массив сообщений. Формат запроса и ответа совместим с POST /v1/chat/completions из OpenAI API.

Возможности эндпоинта вынесены на отдельные страницы: потоковая передача, гарантированный JSON-ответ, вызов функций, анализ изображений и лимиты запросов.

Поля запроса (body)

Алиасы моделей

Поле model принимает три значения, которые разрешаются в модель портала по умолчанию — сейчас это bitrix/bitrixgpt-5.5: auto, bitrix/free или пустая строка.

Модели bitrix/bitrixgpt-5 и bitrix/bitrixgpt-5-vl помечены как устаревшие и работают до 31 июля 2026 года. После этой даты запросы к ним прозрачно перенаправляются на bitrix/bitrixgpt-5.5 с заголовком X-Model-Replacement — подробнее в жизненном цикле моделей.

Кроме того, частичный modelId сопоставляется с каталогом по подстроке: если передан gpt-4o-mini, будет найдена доступная вашему ключу модель, в идентификаторе которой эта подстрока встречается.

Примеры

curl — личный ключ

curl -X POST https://vibecode.bitrix24.tech/v1/chat/completions \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bitrix/bitrixgpt-5.5",
    "messages": [
      {"role": "system", "content": "Ты эксперт по продажам. Классифицируй лидов по качеству."},
      {"role": "user", "content": "ООО Вектор, 50 пользователей, бюджет 500 тысяч в месяц."}
    ],
    "temperature": 0.3,
    "max_tokens": 300
  }'

curl — OAuth-приложение

curl -X POST https://vibecode.bitrix24.tech/v1/chat/completions \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bitrix/bitrixgpt-5.5",
    "messages": [
      {"role": "system", "content": "Ты эксперт по продажам. Классифицируй лидов по качеству."},
      {"role": "user", "content": "ООО Вектор, 50 пользователей, бюджет 500 тысяч в месяц."}
    ],
    "temperature": 0.3,
    "max_tokens": 300
  }'

JavaScript — личный ключ

const res = await fetch('https://vibecode.bitrix24.tech/v1/chat/completions', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'bitrix/bitrixgpt-5.5',
    messages: [
      { role: 'system', content: 'Ты эксперт по продажам. Классифицируй лидов по качеству.' },
      { role: 'user', content: 'ООО Вектор, 50 пользователей, бюджет 500 тысяч в месяц.' },
    ],
    temperature: 0.3,
    max_tokens: 300,
  }),
})

const data = await res.json()
console.log(data.choices[0].message.content)
console.log('Токены:', data.usage.total_tokens)

JavaScript — OAuth-приложение

const res = await fetch('https://vibecode.bitrix24.tech/v1/chat/completions', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'bitrix/bitrixgpt-5.5',
    messages: [
      { role: 'system', content: 'Ты эксперт по продажам. Классифицируй лидов по качеству.' },
      { role: 'user', content: 'ООО Вектор, 50 пользователей, бюджет 500 тысяч в месяц.' },
    ],
    temperature: 0.3,
    max_tokens: 300,
  }),
})

const data = await res.json()
console.log(data.choices[0].message.content)

Поля ответа

Пример ответа

{
  "id": "chatcmpl-a1a73c6eb3f180fd",
  "object": "chat.completion",
  "created": 1777289339,
  "model": "bitrix/bitrixgpt-5.5",
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": {
        "role": "assistant",
        "content": "Качество: ВЫСОКОЕ\n\nОбоснование:\n- Юридическое лицо (ООО) — B2B-клиент\n- Бюджет 500 тысяч в месяц — выше среднего\n- Конкретный объём (50 пользователей) — осознанная потребность\n\nРекомендация: назначить звонок в течение 24 часов."
      }
    }
  ],
  "usage": {
    "prompt_tokens": 42,
    "completion_tokens": 85,
    "total_tokens": 127
  }
}

Пример ответа при ошибке

404 ai_model_not_found — модель не найдена или у ключа нет доступа к ней:

{
  "error": {
    "message": "Model \"anthropic/claude-imaginary-x\" not found or disabled.",
    "type": "invalid_request_error",
    "code": "ai_model_not_found"
  }
}

Ошибки

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

Известные особенности

Автоматическое переключение на резервную модель при сбое провайдера. Если у платной модели произошла ошибка 5xx или таймаут, синхронный запрос повторяется с моделью по умолчанию. В ответе появляется заголовок X-Model-Fallback: <исходный modelId>. В потоковом режиме такого переключения нет — клиент получает ошибку в последнем событии перед data: [DONE].

Исчерпанная квота Cowork/Code: ответ объявляет лимит, а не выполняет запрос. Это отдельное состояние, не имеющее отношения к X-Model-Fallback выше: тот заголовок отмечает подмену модели, здесь же квота подписки исчерпана. Когда окно квоты исчерпано, а на платформе настроена резервная модель, запрос отвечает кодом 200, но работа по нему не делается: поля tools, tool_choice и response_format снимаются, системные сообщения запроса не действуют, и модель сообщает, что лимит достигнут и когда он сбросится. Признаки состояния — заголовок X-Cowork-Fallback: true и предупреждение COWORK_QUOTA_FALLBACK в массиве warnings. В потоковом режиме предупреждения в теле нет, состояние видно по заголовку. Списания за такой ответ нет, квота не расходуется. Не ждите здесь tool_calls и JSON по схеме: даже с response_format в запросе придёт обычный текст. Если резервная модель не настроена — или настроенная сама не ответила, — приходит 402 cowork_quota_exhausted. По коду ответа эти два случая не различаются, поэтому обрабатывайте 402 на этом эндпоинте всегда.

Месячная AI-квота портала. На порталах с включённым контролем квоты запрос может вернуть 402 ai_quota_exhausted. Поле reason различает три случая: breaker — сработал часовой предохранитель расходов сверх квоты, wallet_empty — квота исчерпана и на балансе портала нет средств, wallet_off — расход сверх квоты для портала недоступен. Поле resetAt содержит момент, когда запросы снова начнут проходить, для wallet_off оно может отсутствовать. В ветке wallet_empty ответ может дополнительно нести строку hint с подсказкой и ссылку topupUrl на пополнение баланса — оба поля появляются, когда на платформе включены принудительный контроль квоты и подсказка о пополнении, поэтому читайте их как необязательные. Поле hint в этом ответе — строка. Пока расход укладывается в квоту, поведение эндпоинта не меняется. Сверх квоты, если такой расход для портала разрешён, запросы списываются с денежного баланса портала по базовой цене модели из каталога.

Бюджет обработки синхронного запроса — около 850 секунд. По исчерпании бюджета приходит 503 ai_provider_timeout. Заголовка Retry-After в этом ответе нет намеренно: повтор того же запроса упрётся в тот же бюджет. Сократите объём запроса или перейдите на потоковую передачу — там действует тайм-аут простоя между событиями, а не общий бюджет на весь вызов.

Лимит размера тела запроса — 30 MiB. Этого хватает, чтобы передать одно изображение размером до 20 MiB: после кодирования base64 оно занимает около 27 MiB.

Передача content массивом. Для текстовых моделей передавайте content строкой. Массив с одним элементом text тоже работает, но избыточен. Массив обязателен только для запросов с изображениями.

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

• Потоковая передача
• Гарантированный JSON-ответ
• Вызов функций
• Анализ изображений
• Лимиты запросов
• Жизненный цикл моделей
• Список моделей
• AI Router