Изображения
Открыть .md

Изображения

POST /v1/images/generations — генерация изображений по промпту и референсам.

POST /v1/images/generations — генерация изображений в формате OpenAI Images. Работает только с моделями изображений из каталога.

Запрос

curl https://ai-seller.vibe-codes.ru/v1/images/generations \
  -H "Authorization: Bearer $AISELLER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5",
    "prompt": "Лиса в неоновом городе, акварель",
    "n": 1,
    "size": "1024x1024"
  }'

Ответ

json
{
  "created": 1790000000,
  "data": [{"b64_json": "iVBORw0KGgo..."}]
}

Особенности

  • Ответ всегда без стриминга, генерация может идти минуты — ставьте таймаут клиента с запасом.
  • Изображения приходят в data[].b64_json. Если провайдер отдал ссылку, шлюз скачивает файл сам — ссылок на хранилище провайдера в ответе нет.
  • n — от 1 до 10. Списывается цена за каждое доставленное изображение, но не больше n.
  • Референсы передаются полями image / images — ссылкой или data:-URL в base64. Лимит тела запроса — 70 МиБ.
  • Остальные параметры (size, aspect_ratio, resolution, quality, background, output_format, output_compression) передаются модели как есть; какие значения она поддерживает, решает её провайдер.

Ошибки генерации

HTTPcodeЧто делать
400content_policy_violationПромпт отклонён политикой контента — измените его.
400invalid_imageМодель отклонила референс — попробуйте другое изображение.
422generation_failedМодель не вернула изображение — повторите запрос или переформулируйте промпт.

Остальные коды — в разделе Ошибки.

Обновлено 29 сентября 2026 г.