Skip to main content
POST
  • Официальная модель OpenAI gpt-image-2
  • Асинхронная обработка — возвращает ID задачи для последующего опроса
  • Поддержка text-to-image, image-to-image с несколькими reference-изображениями и inpainting (mask)
  • 13 соотношений сторон с тремя уровнями разрешения: 1K / 2K / 4K
  • До 4 изображений за запрос, до 16 reference-изображений
Примечание: gpt-image-2 не поддерживает прозрачный фон. Параметр background: "transparent" будет автоматически понижен до auto.

Авторизация

string
обязательно
Все запросы требуют аутентификации Bearer TokenПолучите API Key на странице управления API ключамиДобавьте в заголовок запроса:

Тело запроса

string
по умолчанию:"gpt-image-2"
обязательно
Название модели генерации изображенийИспользуйте gpt-image-2
string
обязательно
Текстовый промпт для генерации изображенияПоддерживается русский, английский и китайский языки; рекомендуется детально описывать сцену, стиль и композицию
string
по умолчанию:"1:1"
Соотношение сторонПоддерживаемые значения, или auto для автоматического выбора:1:1 · 3:2 · 2:3 · 4:3 · 3:4 · 5:4 · 4:5 · 16:9 · 9:16 · 2:1 · 1:2 · 21:9 · 9:21
4K-режим поддерживает только 6 соотношений: 16:9 / 9:16 / 2:1 / 1:2 / 21:9 / 9:21. Для остальных используйте 1K или 2K.
string
по умолчанию:"1k"
Уровень разрешения
  • 1k — база 1024 пикс., быстро и экономично (по умолчанию)
  • 2k — база 2048 пикс., подходит для постеров и HD-контента
  • 4k — база 3840 пикс., только 6 соотношений выше; high качество может занять >120с

Таблица размеров

string
по умолчанию:"high"
Качество изображения
  • low — быстро и экономично, для черновиков/превью
  • medium — баланс скорости и качества
  • high — максимальная детализация, по умолчанию (4K + high занимает 120с+)
string
по умолчанию:"png"
Формат вывода
  • png — по умолчанию
  • jpeg — меньший размер файла (поддерживает сжатие)
Azure OpenAI не поддерживает формат webp.
integer
по умолчанию:100
Уровень сжатия JPEG, диапазон 0–100 (0 — без сжатия, 100 — максимальное сжатие, по умолчанию 100)Применяется только при output_format: "jpeg"
integer
по умолчанию:1
Количество генерируемых изображенийДиапазон: 1 ~ 10
string[]
Массив URL reference-изображений для image-to-image генерации
  • Максимум 16 изображений, должны быть публично доступными стабильными URL
  • Используйте API загрузки изображений для получения URL
string
URL маски для inpaintingИспользуется совместно с image_urls. Маска должна совпадать по размеру с первым reference-изображением и содержать Alpha-канал (прозрачные области — это зоны для перерисовки)

Ответ

string
Уникальный идентификатор задачи
string
Тип объекта, всегда generation.task
string
Используемая модель
string
Статус задачи
  • queued — ожидает обработки
  • in_progress — обрабатывается
  • completed — успешно завершена
  • failed — ошибка
integer
Прогресс задачи в процентах (0-100)
integer
Время создания задачи (Unix timestamp)