Перейти к основному содержанию

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

Используйте официальный gpt-image-2.5-flare или gpt-image-2.5-sunburst и добавьте два поля в запрос:
Изображение возвращается в формате PNG с настоящим альфа-каналом — дополнительная постобработка по вырезанию фона не требуется. Поддерживаются как генерация изображений по тексту, так и редактирование изображений.
gpt-image-2 больше не поддерживает прозрачный фон. OpenAI отключила background: "transparent" для gpt-image-2 2026-09-30 (функция находилась в статусе preview с 2026-08-21) и рекомендует пользователям перейти на gpt-image-2.5-flare или gpt-image-2.5-sunburst, которые поддерживают прозрачность нативно. Запрос с прозрачностью к gpt-image-2 теперь отклоняется самой OpenAI с ошибкой 400 Transparent background is not supported for this model. (без тарификации). APIYI провела повторное тестирование 2026-10-15: все 14 запросов генерации изображений по тексту и 7 запросов редактирования изображений были отклонены. Просто замените model на одну из двух моделей 2.5 и оставьте всё остальное без изменений — у всех трех моделей одинаковая цена и параметры.

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

Если вам гарантированно нужна прозрачность, используйте gpt-image-2.5-flare (text-to-image) или gpt-image-2.5-sunburst (редактирование). Параметр и запрос через prompt — не одно и то же: первое гарантируется API, второе — лишь попытка модели сделать всё возможное. При пакетной обработке эта разница становится очевидной.

Два способа вызова

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

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

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

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

У JPEG нет альфа-канала — прозрачность негде хранить. При сочетании output_format: "jpeg" с background: "transparent" возвращается 400:
Для прозрачности выберите 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 строкой 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" расходуют точно такое же количество tokens изображений, тарифицируемых по стандартным правилам за token используемой вами модели (модели 2.5 тарифицируются так же, как gpt-image-2).

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

Вы вызываете gpt-image-2. OpenAI отключила поддержку прозрачного фона 2026-09-30; эта ошибка 400 поступает напрямую от OpenAI и не тарифицируется. Переключите model на gpt-image-2.5-flare (генерация по тексту) или gpt-image-2.5-sunburst (редактирование), оставив остальные параметры без изменений.
Параметр output_format был установлен в jpeg. Измените его на png или webp.
Проверьте три вещи. Во-первых, действительно ли поле background дошло до API — эндпоинт редактирования использует multipart/form-data, поэтому оно должно быть -F background=transparent, а не полем в теле JSON. Во-вторых, совпадает ли значение поля верхнего уровня background в ответе с transparent. В-третьих, используете ли вы gpt-image-2.5-flare / gpt-image-2.5-sunburst — у gpt-image-2-all и gpt-image-2-vip такого параметра нет, и они просто молча игнорируют его, в то время как gpt-image-2 возвращает 400.Если все три пункта проверены, но вы по-прежнему получаете белый или сплошной фон, prompt (или референсное изображение) практически наверняка описывает сцену — модель нарисовала окружение, о котором ее попросили, и параметр не может это переопределить. См. раздел «Не описывайте сцену в prompt» выше.
Достаточно одного фрагмента кода на Python:
Режим RGB означает, что альфа-канал отсутствует вовсе. Режим RGBA, где каждое значение альфа-канала равно 255, означает, что канал существует, но ничего вырезано не было.
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

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

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