Skip to main content
POST

Авторизация

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

Body

string
по умолчанию:"gpt-image-2-official"
обязательно
Название модели генерации изображенийФиксируется как gpt-image-2-official (официальная модель OpenAI gpt-image-2)
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации изображения.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
обязательно
Текстовое описание для генерации изображения
  • Поддерживается английский и китайский, рекомендуются подробные описания
  • Перед отправкой контент проходит модерацию / проверку безопасности — нарушения отклоняются немедленно
string
по умолчанию:"1:1"
Соотношение сторон изображенияВнешне используются значения соотношений; внутри они автоматически сопоставляются с реальными пикселями согласно resolution.Поддерживаемые соотношения плюс auto, чтобы сервер автоматически выбрал подходящее соотношение:
  • auto — Автоматически (сервер выбирает соотношение по prompt / эталонным изображениям)
  • 1:1 — Квадрат (по умолчанию, аватары соцсетей / логотипы)
  • 3:2 — Горизонтальное (распространённое соотношение DSLR)
  • 2:3 — Вертикальное (вертикальные постеры)
  • 4:3 — Горизонтальное (классические мониторы / слайд-шоу)
  • 3:4 — Вертикальное
  • 5:4 — Горизонтальное
  • 4:5 — Вертикальное (вертикальная публикация Instagram)
  • 16:9 — Горизонтальное (превью широкоформатных видео)
  • 9:16 — Вертикальное (полный экран телефона / обложка короткого видео)
  • 2:1 — Горизонтальное (веб-баннер)
  • 1:2 — Вертикальное
  • 3:1 — Горизонтальное (сверхширокий баннер)
  • 1:3 — Вертикальное (очень высокий постер)
  • 21:9 — Горизонтальное (кинематографический сверхширокий)
  • 9:21 — Вертикальное
Размеры в пикселях также можно передавать напрямую, например 1881x836 / 887x1774.
Когда size установлено в auto, соотношение по умолчанию — 1:1.
string
по умолчанию:"1k"
Уровень разрешения (новое поле)Управляет фактической чёткостью вывода.
  • 1k — База 1024, экономичный вариант для повседневного использования (по умолчанию)
  • 2k — База 2048, подходит для постеров / нужд высокой чёткости
  • 4k — База 3840, поддерживает 15 соотношений из таблицы сопоставления ниже
4K поддерживает 15 соотношений из таблицы сопоставления ниже; вы также можете передавать размеры в пикселях из таблицы напрямую через size.
string
по умолчанию:"auto"
Качество изображения
  • auto — Автоматически (по умолчанию, обычно эквивалентно low)
  • low — Быстро и экономично, достаточно для черновых набросков
  • medium — Сбалансированно
  • high — Максимальная точность (4K + high может занимать более 120 с)
string
по умолчанию:"auto"
Режим фона
  • auto — Автоматически (по умолчанию)
  • opaque — Непрозрачный
  • transparent — Запрашивает прозрачный фон; выходное изображение содержит альфа-канал
string
по умолчанию:"auto"
Строгость модерации
  • auto — Стандартная строгость модерации
  • low — Более мягкая модерация
string
по умолчанию:"png"
Выходной формат
  • png — Формат по умолчанию, поддерживает прозрачный фон
  • jpeg — Меньшие файлы, альфа-канал не поддерживается
  • webp — Поддерживает прозрачный фон, подходит для современных браузеров
Если background имеет значение transparent, можно выбрать только png или webp.
integer
Уровень сжатия вывода, диапазон 0–100
  • Действует только для jpeg / webp
integer
по умолчанию:"1"
Количество генерируемых изображенийДиапазон: 1 ~ 4
Должно быть обычным числом (например, 1), не заключайте в кавычки
array
Массив URL эталонных изображений
string
URL маски, используется для inpainting
  • Должен использоваться вместе с image_urls
  1. Перед загрузкой убедитесь, что у маски есть альфа-канал.
  2. Размер маски должен совпадать с первым эталонным изображением.

Сопоставление Size × Resolution

size × resolution → реальные пиксели OpenAI (15 соотношений × 3 уровня):
Примечание: Некоторые размеры приближены к кратным 16 и ограничениям по пикселям, например 3:2 / 2:3 @ 2K — это 2048×1360, а 21:9 @ 4K — 3840×1648. В качестве источника истины используйте фактические пиксели из таблицы.

Примеры использования

Text-to-image (минимальный запрос)
Text-to-image (стикер с прозрачным фоном)
Image-to-image (удаление фона)
Постер высокой чёткости 2K
Обои 4K
Image-to-image (объединение нескольких эталонов)
Inpainting (mask)
Несколько изображений (n > 1)
Прямая строка пикселей (для опытных пользователей)

Response

integer
Код состояния ответа
array
Массив данных ответа

Запрос результатов задачи

После успешной отправки возвращается task_id. Опрашивайте статус задачи через GET /v1/tasks/{task_id}, подробнее см. в API запроса задач.

Пример успешного ответа

Поле usage показывает тарифицируемый расход токенов для этого запроса: При генерации изображений вывод состоит в основном из токенов изображения, поэтому output_tokens_details.image_tokens обычно равно output_tokens. В примере выше total_tokens = 22 + 196 = 218. Поток статусов задачи: submittedin_progresscompleted / failed. Доступ к изображению: data.result.images[0].url[0].