Skip to main content
POST
Совместимость названий моделей: данный интерфейс также поддерживает алиас gpt-image-2-ext, эквивалентный gpt-image-2; они взаимозаменяемы и дают одинаковый результат.

Авторизация

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

Body

string
по умолчанию:"gpt-image-2"
обязательно
Название модели генерации изображенийФиксируется как gpt-image-2 (совместимый алиас gpt-image-2-ext)
Для совместимости со старыми вызовами алиас gpt-image-2-ext (соответствует gpt-image-2) по-прежнему доступен для использования.
boolean
по умолчанию:"false"
Выполнять ли проверку содержимого перед отправкой задачи генерации изображения.
  • true: проверить промпты и входные изображения с помощью omni-moderation-latest
  • false или параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
string
обязательно
Текстовое описание для генерации изображения
  • Поддерживается английский и китайский, рекомендуются подробные описания
  • Перед отправкой контент проходит модерацию / проверку безопасности — нарушения отклоняются немедленно
integer
по умолчанию:"1"
Количество генерируемых изображенийЗначение: 1
Должно быть обычным числом (например, 1), не заключайте в кавычки
string
по умолчанию:"1:1"
Соотношение сторон изображенияПоддерживаемые соотношения плюс auto, чтобы сервер автоматически выбрал подходящее соотношение:Размеры в пикселях также можно передавать напрямую, например, 1881x836 / 887x1774.
Когда size установлено в auto, соотношение по умолчанию — 1:1.
string
по умолчанию:"1k"
Уровень разрешения выводаВарианты: 1k / 2k / 4kСопоставление size × resolution → фактические пиксели:
4K поддерживает перечисленные выше 15 соотношений; вы также можете передавать размеры в пикселях из таблицы напрямую через size.
array
Массив эталонных изображений (стандартное поле OpenAI). При наличии переключается в режим image-to-image.
Другие стандартные поля OpenAI (response_format, style) не поддерживаются и игнорируются. В результатах задачи возвращается только url — при необходимости скачайте и преобразуйте в base64 самостоятельно.
boolean
по умолчанию:"false"
Использовать ли резервный официальный канал
  • false: Не использовать (по умолчанию)
  • true: Использовать официальный канал

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

Text-to-image (минимальный запрос)
Text-to-image (с соотношением + 2K)
Text-to-image (вывод 4K)
Text-to-image (несколько)
Image-to-image (эталон = URL)
Image-to-image (эталон = base64)
Image-to-image (объединение нескольких эталонов, URL + base64 в смешанном виде)

Response

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

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

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

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

Доступ к изображению: data.result.images[0].url[0]

Статусы задачи