Сгенерировать изображение

POST /v1/images/generations

Создаёт одну картинку по текстовому описанию моделью BitrixGPT 5.6 Image и возвращает её в формате base64. Платформа изображения не хранит, поэтому сохраните картинку на своей стороне.

Картинка учитывается в AI-квоте портала: в рамках квоты тарифа деньги с баланса не списываются, сверх квоты каждая картинка оплачивается с баланса портала по цене из поля pricing.perCall модели в GET /v1/models. С ключом Cowork/Code — ключом со скоупом vibe:cowork — картинка расходует квоту сиденья подписки Cowork/Code, а не AI-квоту портала. Неудачный вызов не оплачивается. Формат запроса и ответа совместим с POST /v1/images/generations из OpenAI API.

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

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

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

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

Поле вне этого списка отклоняется с 400 invalid_request.

Примеры

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

curl -X POST https://vibecode.bitrix24.tech/v1/images/generations \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bitrix/bitrixgpt-5.6-image",
    "prompt": "Рыжая лиса сидит на камне у озера, акварель",
    "size": "512x512",
    "output_format": "jpeg"
  }'

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

curl -X POST https://vibecode.bitrix24.tech/v1/images/generations \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bitrix/bitrixgpt-5.6-image",
    "prompt": "Рыжая лиса сидит на камне у озера, акварель",
    "size": "512x512",
    "output_format": "jpeg"
  }'

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

const res = await fetch('https://vibecode.bitrix24.tech/v1/images/generations', {
  method: 'POST',
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'bitrix/bitrixgpt-5.6-image',
    prompt: 'Рыжая лиса сидит на камне у озера, акварель',
    size: '512x512',
    output_format: 'jpeg',
  }),
})

const result = await res.json()
// Адрес вида data: подходит для атрибута src тега img
const dataUrl = `data:image/jpeg;base64,${result.data[0].b64_json}`
console.log('Картинка готова:', dataUrl.slice(0, 60))

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

const res = await fetch('https://vibecode.bitrix24.tech/v1/images/generations', {
  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.6-image',
    prompt: 'Рыжая лиса сидит на камне у озера, акварель',
    size: '512x512',
    output_format: 'jpeg',
  }),
})

const result = await res.json()
const dataUrl = `data:image/jpeg;base64,${result.data[0].b64_json}`
console.log('Картинка готова:', dataUrl.slice(0, 60))

Поля ответа

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

Строка b64_json сокращена: в настоящем ответе это картинка целиком, для JPEG 512×512 — около 140 КБ.

{
  "created": 1789740000,
  "data": [
    { "b64_json": "/9j/4AAQSkZJRgABAQAAAQABAAD..." }
  ],
  "output_format": "jpeg",
  "size": "512x512"
}

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

400 invalid_request — сторона картинки больше 1024 пикселей:

{
  "error": {
    "message": "size: each side must be between 64 and 1024 pixels",
    "type": "invalid_request_error",
    "code": "invalid_request"
  }
}

Ошибки

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

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

Модель ищется по возможности, а не по имени. Модель генерации изображений приходит в общем списке GET /v1/models вместе с чат-моделями и отличается от них полем capabilities.image_generation. Если такой модели в списке нет, генерация изображений вашему ключу или порталу недоступна, и эндпоинт ответит 404. Вшивать идентификатор модели в код не нужно.

Только текстовое описание. Картинку на вход эндпоинт не принимает — поля для изображения-образца в теле запроса нет. Что должно быть на картинке, задаёт prompt, чего на ней быть не должно — negative_prompt.

В рамках квоты — без списаний, сверх квоты — по цене за картинку. С ключом без скоупа vibe:cowork каждая успешная картинка расходует месячную AI-квоту портала. Если расход укладывается в квоту тарифа, деньги с баланса не списываются. Сверх квоты картинка оплачивается с баланса портала по цене из pricing.perCall. Когда квота исчерпана, а оплата сверх неё невозможна, эндпоинт отвечает 402 ai_quota_exhausted. Поле reason различает три случая: breaker — сработал часовой предохранитель расходов сверх квоты, wallet_empty — на балансе портала нет средств, wallet_off — расход сверх квоты для портала недоступен. Поле resetAt — момент, когда запросы снова начнут проходить, для wallet_off оно может отсутствовать. Когда у портала нет оплаченного доступа к AI-моделям, ответ с reason: "wallet_off" дополнительно несёт details.learnMoreUrl — страницу с описанием подписки или тарифа Битрикс24, в которые входит AI, а поле message называет нужный продукт. При других причинах wallet_off поля details.learnMoreUrl нет. Ключ Cowork/Code этим путём не идёт: картинка расходует квоту сиденья, а когда она исчерпана, ответ — 402 cowork_quota_exhausted. Списания с баланса портала по pricing.perCall и отказа ai_quota_exhausted на этом пути нет.

Одновременных запросов ограниченное число. Сервис генерации обрабатывает ограниченное число запросов одновременно, остальные ждут своей очереди. Когда очередь заполнена, запрос сразу получает 429 ai_image_congested и в генерацию не попадает. Картинка, которая не готова за 60 секунд, заканчивается ответом 503 ai_provider_timeout. Чем больше num_inference_steps и размер картинки, тем дольше ждёт и ваш запрос, и очередь за ним.

Картинки не хранятся. Изображение приходит только в ответе, в поле data[].b64_json: ссылок на файлы платформа не выдаёт, повторно скачать картинку с платформы нельзя. Сохраните её сразу после ответа.

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

• Список моделей
• Расход и лимиты
• AI Router