Перейти к основному содержанию
POST
  • Унифицированный API генерации изображений
  • Выбор модели gpt-image-2 через параметр model
  • Поддержка text-to-image, single-reference и multi-reference generation
  • Асинхронное управление задачами с получением результата по task ID
Важное изменение: Для повышения производительности и контроля затрат base64 больше не поддерживается в image_urls и reference_images. Сначала используйте API загрузки изображений, затем передайте полученный URL.

Авторизация

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

Тело запроса

model
string
по умолчанию:"gpt-image-2"
обязательно
Название модели генерации изображенийПример: "gpt-image-2"
prompt
string
обязательно
Текстовый промпт для генерации изображенияМаксимум 32 000 символов для GPT image models
size
string
по умолчанию:"1:1"
Соотношение сторон выходного изображенияСейчас поддерживаются следующие соотношения: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
resolution
string
по умолчанию:"1k"
Уровень разрешения изображенияПоддерживаемые значения: 1k, 2k, 4k

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

n
integer
по умолчанию:1
Количество изображенийПо умолчанию: 1
response_format
string
по умолчанию:"url"
Формат ответаAPI возвращает URL изображения, рекомендуемое значение: url
reference_images
string[]
URL эталонных изображений для image-to-image⚠️ Только URL (base64 больше не поддерживается)
  • Публично доступные URL (http:// или https://)
  • Можно использовать API загрузки изображений для загрузки локальных файлов
  • Поддерживаются одиночные и множественные reference images
image_urls
string[]
Поле обратной совместимостиВ ToAPIs автоматически нормализуется в reference_images

Ответ

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