Как сгенерировать изображения с прозрачным фоном (PNG-вырезки)

Краткий ответ

Используйте gpt-image-2 и добавьте в запрос два поля:

{
  "model": "gpt-image-2",
  "prompt": "a cute cartoon fox sticker, clean cutout edges, no shadow",
  "background": "transparent",
  "output_format": "png"
}

Изображение возвращается в формате PNG с настоящим альфа-каналом — дополнительная постобработка для вырезания не требуется. Поддерживаются как генерация изображений по тексту, так и редактирование изображений.

background: "transparent" — это возможность, которую OpenAI открыла для GPT-Image-2 21.08.2026 (OpenAI пометила её как предварительную версию). APIYI проверила её от начала до конца: и генерация изображений по тексту, и редактирование изображений возвращают настоящую прозрачность альфа-канала.

Какие модели могут создавать прозрачный фон

Модель	Как	Надёжность
`gpt-image-2.5-flare` / `gpt-image-2.5-sunburst` / `gpt-image-2`	Параметр — `background: "transparent"` с `output_format`, установленным в `png` или `webp` (одинаковые параметры для всех трёх)	✅ Надёжно, рекомендуется (при условии, что промпт не описывает сцену — см. ниже)
`gpt-image-1.5` / `gpt-image-1`	Тот же параметр	✅ Надёжно (более старые модели; в новых проектах следует просто использовать `gpt-image-2.5-flare`)
`gpt-image-2-all` / `gpt-image-2-vip`	Без параметра `background` — его можно только запросить в промпте	⚠️ Иногда ненадёжно; тот же промпт всё ещё может вернуть изображение на белом фоне
`seedream-5-0` / `seedream-5-0-pro`	`output_format: "png"` плюс `transparent background, alpha channel` в промпте	⚠️ Зависит от промпта, наличие альфа-канала не гарантируется при каждом вызове
Графические модели Gemini (семейство Nano Banana)	Только промпт	⚠️ То же, что указано выше
`seedream-4-5` / `seedream-4-0`	Только вывод `jpeg`, без альфа-канала	❌ Не поддерживается

Если вам нужна надёжная прозрачность, используйте gpt-image-2. Параметр и запрос в промпте — не одно и то же: первое гарантируется API, а второе означает, что модель делает всё возможное. При обработке больших объёмов разница становится заметной.

Два способа вызвать его

Текст-в-изображение `/v1/images/generations`

curl https://api.apiyi.com/v1/images/generations \
  -H "Authorization: Bearer $APIYI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a cute cartoon fox sticker, flat vector illustration, single centered subject, clean cutout edges, no background, no shadow",
    "background": "transparent",
    "output_format": "png",
    "quality": "low"
  }'

Редактирование изображений `/v1/images/edits`

Передайте ему обычную фотографию и попросите удалить фон:

curl https://api.apiyi.com/v1/images/edits \
  -H "Authorization: Bearer $APIYI_API_KEY" \
  -F model=gpt-image-2 \
  -F [email protected] \
  -F 'prompt=remove the background completely and keep only the fox, clean cutout edges, no shadow' \
  -F background=transparent \
  -F output_format=png

Инпейтинг на основе маски (mask) и прозрачный фон работают вместе — они не конфликтуют.

Почему `jpeg` не работает

У JPEG нет альфа-канала — прозрачность негде хранить. При сочетании output_format: "jpeg" с background: "transparent" возвращается 400:

{
  "error": {
    "message": "Transparent background is not supported for JPEG output format",
    "param": "background",
    "code": "invalid_value"
  }
}

Для прозрачности выберите png (без потерь, больше) или webp (с потерями и настраиваемый, меньше, также поддерживает альфа-канал). webp также принимает output_compression, чтобы уменьшить размер файла.

Редактирование — это перерисовка, а не точное вырезание

Сразу задайте ожидания: когда /v1/images/edits выполняется с background: transparent, модель понимает сцену и заново рисует объект, а не обводит исходный контур так, как это сделал бы Photoshop. Это означает:

Позу, стиль и мелкие детали объекта будет меняться — это не сохранение на уровне пикселей
Чтобы оставаться ближе к оригиналу, используйте quality: "high" и укажите в prompt: “сохраните исходную композицию, не меняйте внешний вид объекта”
Если вашему workflow нужно извлечение с точностью до пикселя, выполните вырезание самостоятельно с помощью rembg, PIL или sharp. Генерация модели лучше подходит для “создания переиспользуемых assets”, чем для точного matting

Не описывайте сцену в prompt — параметр не может её переопределить

background: "transparent" гарантирует только альфа-канал и направляет модель в сторону изолированного объекта. Если prompt или референсное изображение описывает полноценную сцену, модель рисует эту сцену, и параметр её не остановит. Это самая распространённая причина, почему прозрачный результат «иногда работает, иногда нет», и она никак не связана с уровнем качества. Измерено 2026-09-11 с gpt-image-2.5-sunburst, 30 вызовов (половина со средним качеством, половина с высоким, text-to-image плюс редактирование референсных изображений):

Стиль prompt	Фактическая прозрачность
Только объект (яблоко, наушники, мечник), с указанием изоляции / отсутствия фона	16 / 16, среднее и высокое качество одинаково стабильны
Описана сцена: «мечник в осеннем лесу с красными кленовыми листьями»	0 / 3, был нарисован весь лес, как при среднем, так и при высоком качестве
Та же сцена переписана: несколько кленовых листьев кружатся вокруг мечника + `isolated character on a transparent background, no scenery, no ground`	2 / 2
Референсное изображение имеет полноценный фон, prompt описывает только сцену и никогда не запрашивает изолированный объект	1 / 2, случайный результат
Референсное изображение имеет полноценный фон, в prompt указано `remove the scenery entirely, keep only the subject`	8 / 8

Три правила написания:

❌ Избегайте слов окружения — земля, небо, комната, лес. Если вам нужна атмосфера, привязывайте её к объекту («несколько падающих кленовых листьев», а не «кленовый лес»)
✅ Завершайте каждый prompt строкой isolated subject on a transparent background, no scenery, no ground, no shadow
✅ Если референсное изображение имеет фон, укажите remove the background entirely, keep only the character в prompt для редактирования

Повышение quality с medium до high не делает прозрачность надёжнее; оно лишь требует в 4 раза больше tokens (439 → 1,756).

Тарификация

Прозрачность не требует доплаты. При том же уровне качества и размере background: "transparent" и background: "opaque" используют абсолютно одинаковое количество image tokens и тарифицируются по обычным правилам за token для gpt-image-2.

Распространённые ошибки

400: Прозрачный фон не поддерживается для формата вывода JPEG

output_format было задано как jpeg. Переключите его на png или webp.

Изображение действительно на белом фоне, а не прозрачное

Проверьте три вещи. Во-первых, что поле background действительно дошло до API — эндпоинт редактирования имеет тип multipart/form-data, поэтому это должно быть -F background=transparent, а не полем в теле JSON. Во-вторых, возвращает ли background верхнего уровня в ответе значение transparent. В-третьих, используете ли вы gpt-image-2 — у gpt-image-2-all и gpt-image-2-vip такого параметра нет, и они молча его игнорируют.Если все три условия выполнены, но вы всё равно получаете белый или полный фон, prompt (или эталонное изображение) почти наверняка описывает сцену — модель нарисовала окружение, которое её попросили создать, и параметр не может это переопределить. См. выше раздел «Не описывайте сцену в prompt».

Как подтвердить, что изображение действительно имеет альфа-канал

Достаточно одного фрагмента Python:

from PIL import Image
im = Image.open("out.png")
print(im.mode)                      # RGBA means it has alpha
a = im.convert("RGBA").getchannel("A")
print(a.histogram()[0] / (im.width * im.height))   # share of fully transparent pixels

Режим RGB означает, что альфа-канал полностью отсутствует. Режим RGBA, при котором все значения альфа равны 255, означает, что канал существует, но ничего не было вырезано.

В моём prompt уже указан прозрачный фон — зачем также передавать параметр

Prompt лишь просит модель нарисовать это таким образом, а модель может нарисовать серо-белую шахматную сетку, которая только выглядит прозрачной, — это всё равно непрозрачные пиксели. Только параметр background: "transparent" гарантирует настоящий альфа-канал. Верно и обратное: параметр гарантирует канал, но не может переопределить сцену, описанную в prompt, — они должны работать вместе.

Связанная документация

Обзор GPT-Image-2

Полный список параметров, размеров, уровней качества и кодов ошибок

Справочник API преобразования текста в изображение

Все поля в /v1/images/generations

Справочник API редактирования изображений

/v1/images/edits и объединение нескольких изображений

Инпейтинг с маской

Используйте альфа-маску, чтобы отметить область для изменения

Официальные и обратные маршруты

Выбор между gpt-image-2.5-flare / sunburst / gpt-image-2 / -all / -vip

Артефакты на белом фоне

Другая проблема с чисто белым фоном

Основы

Базовый API

Image API (официальный)

Video API (официальный)

API мультимодального понимания

Генерация текста

Audio API (официальный)

Поиск и безопасность

Как сгенерировать изображения с прозрачным фоном (PNG-вырезки)

Краткий ответ

Какие модели могут создавать прозрачный фон

Два способа вызвать его

Текст-в-изображение `/v1/images/generations`

Редактирование изображений `/v1/images/edits`

Почему `jpeg` не работает

Редактирование — это перерисовка, а не точное вырезание

Не описывайте сцену в prompt — параметр не может её переопределить

Тарификация

Распространённые ошибки

Связанная документация

Обзор GPT-Image-2

Справочник API преобразования текста в изображение

Справочник API редактирования изображений

Инпейтинг с маской

Официальные и обратные маршруты

Артефакты на белом фоне

​Краткий ответ

​Какие модели могут создавать прозрачный фон

​Два способа вызвать его

​Текст-в-изображение /v1/images/generations

​Редактирование изображений /v1/images/edits

​Почему jpeg не работает

​Редактирование — это перерисовка, а не точное вырезание

​Не описывайте сцену в prompt — параметр не может её переопределить

​Тарификация

​Распространённые ошибки

​Связанная документация

Обзор GPT-Image-2

Справочник API преобразования текста в изображение

Справочник API редактирования изображений

Инпейтинг с маской

Официальные и обратные маршруты

Артефакты на белом фоне

Краткий ответ

Какие модели могут создавать прозрачный фон

Два способа вызвать его

Текст-в-изображение `/v1/images/generations`

Редактирование изображений `/v1/images/edits`

Почему `jpeg` не работает

Редактирование — это перерисовка, а не точное вырезание

Не описывайте сцену в prompt — параметр не может её переопределить

Тарификация

Распространённые ошибки

Связанная документация