GPT-Image-2
Генерация изображений GPT-Image-2 (официальный канал)
- Официальная модель OpenAI
gpt-image-2, основанная на совместимом протоколе/v1/images/generations - Асинхронная обработка, возвращается
task_idдля последующих запросов - Text-to-image / image-to-image / inpainting (mask) — всё в одном
- Поддержка прозрачного фона PNG / WebP (альфа-канал)
- Новое поле уровня
resolution— выбор 1K / 2K / 4K - 15 соотношений сторон во всех уровнях 1K / 2K / 4K
- До 4 изображений за запрос, до 16 эталонных изображений
- Совпадение параметров с
gpt-image-1.5-officialна 95% — для миграции достаточно сменить имя модели
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-latestfalseили параметр не указан: не отправлять запрос на проверку, без дополнительных затрат и задержки (по умолчанию)
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.string
по умолчанию:"1k"
Уровень разрешения (новое поле)Управляет фактической чёткостью вывода.
1k— База 1024, экономичный вариант для повседневного использования (по умолчанию)2k— База 2048, подходит для постеров / нужд высокой чёткости4k— База 3840, поддерживает 15 соотношений из таблицы сопоставления ниже
string
по умолчанию:"auto"
Качество изображения
auto— Автоматически (по умолчанию, обычно эквивалентноlow)low— Быстро и экономично, достаточно для черновых набросковmedium— Сбалансированноhigh— Максимальная точность (4K + high может занимать более 120 с)
string
по умолчанию:"auto"
Режим фона
auto— Автоматически (по умолчанию)opaque— Непрозрачныйtransparent— Запрашивает прозрачный фон; выходное изображение содержит альфа-канал
string
по умолчанию:"auto"
Строгость модерации
auto— Стандартная строгость модерацииlow— Более мягкая модерация
string
по умолчанию:"png"
Выходной формат
png— Формат по умолчанию, поддерживает прозрачный фонjpeg— Меньшие файлы, альфа-канал не поддерживаетсяwebp— Поддерживает прозрачный фон, подходит для современных браузеров
integer
Уровень сжатия вывода, диапазон
0–100- Действует только для
jpeg/webp
integer
по умолчанию:"1"
Количество генерируемых изображенийДиапазон:
1 ~ 4array
Массив URL эталонных изображений
string
URL маски, используется для inpainting
- Должен использоваться вместе с
image_urls
Сопоставление Size × Resolution
size × resolution → реальные пиксели OpenAI (15 соотношений × 3 уровня):
Примечание: Некоторые размеры приближены к кратным 16 и ограничениям по пикселям, например3:2/2:3@ 2K — это 2048×1360, а21:9@ 4K — 3840×1648. В качестве источника истины используйте фактические пиксели из таблицы.
Примеры использования
Text-to-image (минимальный запрос)Response
integer
Код состояния ответа
array
Массив данных ответа
Запрос результатов задачи
После успешной отправки возвращаетсяtask_id. Опрашивайте статус задачи через GET /v1/tasks/{task_id}, подробнее см. в API запроса задач.
Пример успешного ответа
usage показывает тарифицируемый расход токенов для этого запроса:
При генерации изображений вывод состоит в основном из токенов изображения, поэтому
output_tokens_details.image_tokens обычно равно output_tokens. В примере выше total_tokens = 22 + 196 = 218.
Поток статусов задачи: submitted → in_progress → completed / failed.
Доступ к изображению: data.result.images[0].url[0].