Image API: генерация, редактирование и вариации изображений

POST /v2/images/generations — генерация изображений по описанию
Создаёт новое изображение на основе текстового промпта.
Запрос
POST {{API_HOST}}/v2/images/generations
Заголовки
X-Auth-Token: YOUR_API_KEY  
Content-Type: application/json
Тело запроса
{
  "prompt": "A futuristic city at sunset",
  "model": "dall-e-3",
  "size": "1024x1024"
}
Параметр
Тип
Обязателен
Описание
prompt
string
Да
Описание изображения
model
string
Да
Модель генерации, напр. dall-e-3
Список вендоров моделей
size
string
Нет
Размер изображения (512x512, 1024x1024)
POST /v2/images/edits — редактирование изображения
Позволяет внести правки в изображение на основе текста (inpainting).
Запрос
POST {{API_HOST}}/v2/images/edits
Формат запроса
  • image: исходное изображение (файл)
  • mask: маска (файл, где белое — редактируемое)
  • prompt: описание, что должно быть сгенерировано
  • model: например, dall-e-3
POST /v2/images/variations — вариации изображения
Создаёт новые вариации на основе загруженного изображения.
Запрос
POST {{API_HOST}}/v2/images/variations
Параметры
  • image: исходное изображение
  • model: dall-e-2, dall-e-3 и др.
  • n: количество вариаций
  • size: размер (512x512, 1024x1024)
Применение
  • Создание иллюстраций по текстовому сценарию
  • Генерация маркетинговых баннеров
  • Редактирование изображений (например, удаление/добавление объектов)
  • Генерация похожих изображений (A/B тесты, идеи)