Что делать, если gpt-image-2 больше не создаёт изображения с прозрачным фоном? 3 шага для перехода на серию 2.5 и восстановления прозрачного фона

Примечание автора: OpenAI официально отключила поддержку прозрачного фона в gpt-image-2. В статье разбираем, почему возникает ошибка, и рассказываем, как перейти на серию 2.5, просто изменив название модели, и снова получать PNG с прозрачным фоном.

В последнее время многие разработчики сообщают, что запросы к gpt-image-2 с прозрачным фоном, которые раньше работали без проблем, внезапно стали завершаться ошибкой Transparent background is not supported for this model.. Дело не в неверно заданных параметрах и не в сбое API: 30 сентября 2026 года OpenAI официально отключила в gpt-image-2 поддержку параметра background: "transparent".

Это не временное ограничение на стороне платформы, а изменение со стороны самой OpenAI. При повторной проверке 15 октября мы выполнили 14 запросов на генерацию изображений и 7 запросов на редактирование изображений — все запросы с прозрачным фоном были отклонены официальным API. Запросы с параметрами opaque, auto и без background отрабатывают нормально.

Главное: прочитав статью, вы разберётесь, почему gpt-image-2 перестал поддерживать прозрачный фон и откуда берётся ошибка. А ещё узнаете, как перейти на gpt-image-2.5-flare и gpt-image-2.5-sunburst: обычно достаточно изменить название модели в одной строке, чтобы снова получать изображения с прозрачным фоном.

Главное об ошибке с прозрачным фоном в gpt-image-2

Для начала рассмотрим типичный запрос, который приводит к ошибке. Пользователь отправляет в gpt-image-2 такие параметры, чтобы получить PNG без фона, краёв и ореола:

{
  "model": "gpt-image-2",
  "background": "transparent",
  "output_format": "png",
  "quality": "low",
  "size": "2048x2560",
  "n": "1",
  "prompt": "去掉背景，没有边缘，没有光晕"
}

Интерфейс возвращает следующий текст ошибки. Ключевые поля — code: invalid_value и param: background:

{
  "error": {
    "code": "invalid_value",
    "message": "Transparent background is not supported for this model.",
    "param": "background",
    "type": "shell_api_error"
  }
}

Сообщение об ошибке прямо указывает на проблемный параметр. Основные сведения собраны в таблице:

Почему в gpt-image-2 отключили прозрачный фон

Если посмотреть на хронологию, прозрачный фон в gpt-image-2 с самого начала не был официально поддерживаемой функцией. С 21 августа 2026 года он был доступен в режиме preview — то есть фактически проходил тестирование. 30 сентября OpenAI официально отключила эту preview-функцию и предложила пользователям, которым нужен прозрачный фон, перейти на две модели серии 2.5 с его нативной поддержкой.

Теперь понятно, почему некоторым разработчикам казалось, что «ещё пару месяцев назад всё работало». Если вы подключили прозрачный фон в проекте в конце августа или в сентябре, то использовали preview-функцию. После её отключения запросы перестали работать. Поскольку отказы выдаёт непосредственно OpenAI, обойти это ограничение через сервис-прокси API или агрегатор нельзя. Единственный правильный вариант — перейти на другую модель.

Какие параметры background по-прежнему работают в gpt-image-2

Многие опасаются, что gpt-image-2 целиком перестала работать, но это не так. Отключили только значение transparent — остальные режимы фона работают как обычно. Ниже — результаты повторной проверки от 15 октября:

Поэтому, если прозрачный фон нужен только для некоторых сценариев, не обязательно полностью переходить на другую модель. Разумнее оставить gpt-image-2 для обычной генерации изображений, а запросы, которым нужен прозрачный фон, направлять моделям серии 2.5.

Переход на прозрачный фон в gpt-image-2: 3 шага для быстрого старта

Главный принцип перехода прост: меняем название модели в зависимости от задачи, остальные параметры оставляем как есть. Все три модели стоят одинаково и поддерживают одни и те же параметры, поэтому менять уже настроенные size, quality, output_format и prompt не нужно.

Переход можно выполнить за 3 шага:

1. Найдите нужные запросы: поищите в коде background="transparent" или "background": "transparent", чтобы найти все вызовы с прозрачным фоном.
2. Замените модель в зависимости от задачи: для вызовов images.generate укажите gpt-image-2.5-flare, а для images.edit — gpt-image-2.5-sunburst.
3. Проверьте формат вывода: убедитесь, что для output_format задано значение png или webp. В JPEG нет альфа-канала, поэтому даже при поддержке прозрачности моделью JPEG не сохранит информацию о прозрачности.

Минимальный пример прозрачного фона в gpt-image-2.5-flare

Ниже — самый простой способ генерировать изображения с прозрачным фоном с помощью официального Python SDK OpenAI:

import base64
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"  # APIYI OpenAI 兼容接口
)

result = client.images.generate(
    model="gpt-image-2.5-flare",       # 原 gpt-image-2 改为 flare
    prompt="一只卡通风格的橙色小狐狸贴纸，干净边缘，无光晕",
    background="transparent",
    output_format="png",
    quality="low",
    size="1024x1024",
    n=1,
)

with open("fox.png", "wb") as f:
    f.write(base64.b64decode(result.data[0].b64_json))

И ещё один нюанс: в примере запроса параметр n передан строкой "1". Лучше передавать целое число 1, чтобы избежать ошибок типов в некоторых SDK и при строгой проверке параметров.

Пример редактирования изображений с gpt-image-2.5-sunburst и автоматическим переключением

Если вам нужно убрать фон у существующего изображения, это задача редактирования. Для неё следует использовать интерфейс редактирования вместе с gpt-image-2.5-sunburst. Такой подход лучше соответствует назначению модели, чем просьба «убрать фон» в промпте для генерации изображения.

В следующем примере функции для генерации и редактирования изображений собраны в одном коде. Также предусмотрен запасной сценарий: если старый код по-прежнему отправляет запрос на прозрачный фон в gpt-image-2, при получении ошибки 400 с param=background запрос автоматически повторяется с соответствующей моделью версии 2.5.

import base64
from typing import Optional
from openai import OpenAI, BadRequestError

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.apiyi.com/v1"  # APIYI 统一接口，一个 Key 调用三款模型
)

# 透明背景场景的模型映射
TRANSPARENT_MODEL = {
    "generate": "gpt-image-2.5-flare",     # 文生图
    "edit": "gpt-image-2.5-sunburst",      # 改图 / 编辑
}


def pick_model(task: str, background: Optional[str], model: str) -> str:
    """需要透明背景时，自动选择 2.5 系列模型"""
    if background == "transparent" and model == "gpt-image-2":
        return TRANSPARENT_MODEL[task]
    return model


def is_transparent_rejected(err: BadRequestError) -> bool:
    """识别 gpt-image-2 透明背景被拒的 400 错误"""
    msg = str(err)
    return "Transparent background is not supported" in msg or "background" in msg


def save_b64(b64_data: str, path: str) -> str:
    with open(path, "wb") as f:
        f.write(base64.b64decode(b64_data))
    return path


def generate_image(
    prompt: str,
    out_path: str,
    model: str = "gpt-image-2",
    background: Optional[str] = "transparent",
    size: str = "1024x1024",
    quality: str = "low",
    output_format: str = "png",
) -> str:
    params = dict(
        prompt=prompt,
        size=size,
        quality=quality,
        output_format=output_format,
        n=1,
    )
    if background:
        params["background"] = background

    target = pick_model("generate", background, model)
    try:
        result = client.images.generate(model=target, **params)
    except BadRequestError as e:
        if is_transparent_rejected(e) and target == "gpt-image-2":
            result = client.images.generate(
                model=TRANSPARENT_MODEL["generate"], **params
            )
        else:
            raise
    return save_b64(result.data[0].b64_json, out_path)


def edit_image(
    image_path: str,
    prompt: str,
    out_path: str,
    model: str = "gpt-image-2",
    background: Optional[str] = "transparent",
    output_format: str = "png",
) -> str:
    target = pick_model("edit", background, model)
    with open(image_path, "rb") as img:
        kwargs = dict(
            image=img,
            prompt=prompt,
            output_format=output_format,
            n=1,
        )
        if background:
            kwargs["background"] = background
        result = client.images.edit(model=target, **kwargs)
    return save_b64(result.data[0].b64_json, out_path)


if __name__ == "__main__":
    # 文生图透明底：自动走 gpt-image-2.5-flare
    generate_image("极简风格的咖啡杯图标，扁平设计", "cup.png")

    # 改图去背景：自动走 gpt-image-2.5-sunburst
    edit_image("product.jpg", "去掉背景，保留主体，没有边缘，没有光晕", "product_cut.png")

Совет для быстрого старта: если в проекте используются модели gpt-image-2 и серии 2.5, подключите их через единый интерфейс APIYI apiyi.com. С одним API-ключом можно вызывать все три модели. Новым пользователям доступен бесплатный тестовый лимит — удобно проверить работу с прозрачным фоном до миграции.

Сравнение альтернатив для прозрачного фона в gpt-image-2

Помимо прямого перехода на серию 2.5, некоторые рассматривают вариант «сначала получить изображение на белом фоне с помощью gpt-image-2, а затем удалить фон инструментом для вырезания объектов». У обоих подходов есть свои сценарии применения — сравним их в таблице:

Как выбрать способ получить прозрачный фон в gpt-image-2

Сравнение с последующим удалением фона. Вариант «белый фон + удаление фона» позволяет полностью сохранить стиль изображений gpt-image-2. Но он добавляет ещё один этап обработки, а на сложных участках — например, с тонкими волосами, полупрозрачным стеклом или тенями — могут появиться белые края и ореолы. Именно этого пользователь хотел избежать в промпте из исходного запроса. В отличие от него, модели серии 2.5 сразу выдают изображение с прозрачным каналом: цепочка обработки короче, а вариант лучше подходит для автоматизированного пакетного производства.

Сравнение моделей серии 2.5. gpt-image-2.5-flare и gpt-image-2.5-sunburst — официально рекомендованные OpenAI модели на замену для работы с прозрачным фоном. Цена и параметры у них те же, поэтому переход почти ничего не стоит. Для новых проектов и команд, у которых ещё не настроен процесс удаления фона, прямой переход на серию 2.5 — более надёжный вариант.

Примечание к сравнению: результат зависит от типа ваших материалов. Советуем прогнать один и тот же набор промптов на APIYI apiyi.com и сравнить качество краёв, прежде чем выбирать решение для производства.

Часто задаваемые вопросы

Ключевые выводы о переходе с прозрачного фона в gpt-image-2

• Что отключили: 30 сентября 2026 года OpenAI отключила поддержку прозрачного фона в preview-версии gpt-image-2.
• Как выглядит ошибка: HTTP 400, invalid_value, param: background. Отклонённые запросы не тарифицируются.
• Что по-прежнему работает: gpt-image-2 продолжает генерировать изображения с непрозрачным фоном, а также при значениях auto и при отсутствии параметра background.
• Замена для генерации изображений по тексту: используйте gpt-image-2.5-flare — достаточно изменить только название модели.
• Замена для редактирования изображений: используйте gpt-image-2.5-sunburst. Все три модели стоят одинаково и используют одинаковые параметры.
• Формат файла: для прозрачного фона выбирайте PNG или WebP — JPEG не поддерживает прозрачность.
• Как начать: через APIYI apiyi.com можно вызывать все три модели с помощью одного API-ключа. Перед миграцией проверьте их бесплатно.

Итоги

gpt-image-2 больше не поддерживает генерацию изображений с прозрачным фоном. Дело не в вашем коде: OpenAI официально отключила эту возможность в preview-версии. Кратко напомним, что делать:

1. Убедитесь в причине: если видите Transparent background is not supported for this model., значит, поддержку отключила OpenAI. Запрос не тарифицируется, повторять его не нужно.
2. Выберите модель для своей задачи: для генерации изображений по тексту используйте gpt-image-2.5-flare, для редактирования — gpt-image-2.5-sunburst. Остальные параметры можно оставить без изменений.
3. Добавьте запасной вариант: настройте на уровне вызова соответствие моделей и переход на запасную модель при ошибке 400. Также проверьте, что формат вывода — PNG или WebP.

Для большинства проектов миграция сводится к замене названия модели в одной строке. Рекомендуем быстро проверить генерацию с прозрачным фоном в серии 2.5 через APIYI apiyi.com. Платформа предоставляет совместимый с OpenAI интерфейс и бесплатный тестовый лимит, поэтому переключаться между gpt-image-2 и моделями серии 2.5 будет удобно.

📚 Полезные материалы

1. Справка APIYI: FAQ о прозрачном фоне изображений: информация об отключении прозрачного фона в gpt-image-2 и рекомендации по миграции
2. Ссылка: docs.apiyi.com/faq/image-transparent-background

3. Описание: здесь собраны сведения об ошибках, альтернативных моделях и соответствии параметров — удобно сверяться при миграции и устранении проблем

4. Документация OpenAI по API генерации изображений: описание параметров интерфейсов images.generate и images.edit

5. Ссылка: platform.openai.com/docs/guides/image-generation

6. Описание: официальные определения параметров background, output_format, quality и других

7. Python SDK OpenAI: исходный код и примеры официального клиента

8. Ссылка: github.com/openai/openai-python
9. Описание: примеры кода в этой статье написаны на основе данного SDK. Здесь можно посмотреть типы исключений и способы работы с интерфейсами для изображений

Автор: техническая команда APIYI
Техническое обсуждение: свяжитесь с нами на главной странице сайта APIYI. Другие материалы по подключению моделей для работы с изображениями доступны в центре документации docs.apiyi.com

Читайте также

• Устранение проблемы цветных полос при генерации изображений в GPT Image 2.5: диагностика 5 типов цветных полос и руководство по выбору параметра quality: Разберите 5 типов и причин появления цветных полос и шумов в изображениях gpt-image-2.5-sunburst, объясните связь уровня quality с вычислительным бюджетом, приведите пересчёт «2.5 high ≈ 2 medium», сравнение стоимости и способы устранения без существенного увеличения бюджета.
• 2 способа генерации комплектов изображений для электронной коммерции с помощью gpt-image-2: многомерная обработка одного изображения vs разбор текста + параллельные вызовы (с полным кодом): gpt-image-2: один промпт на запрос, n — варианты того же промпта; статья описывает два подхода — длинное детальное изображение с многомерной информацией и раскадровку моделью вроде gpt-6.1-sol с параллельным вызовом gpt-image-2, код, приёмы единообразия стиля и советы по параллельному масштабированию.
• ИИ-питомцы для рабочего стола захватывают экраны: Nano Banana задаёт образ персонажа, Seedance создаёт движения на зелёном фоне — 3 шага до анимированного питомца с прозрачным фоном: Урок по созданию ИИ-питомца для рабочего стола преимущественно через графический интерфейс: создайте собственного персонажа в Nano Banana, сгенерируйте видео с движениями на зелёном фоне в Seedance, удалите фон с помощью конвейера материалов dsh-pet и получите прозрачный WebM, затем добавьте его в DSH, чтобы питомец ожил на рабочем столе.
• Что делать, если gpt-6-astra поглупел? 5 шагов для диагностики + практическое руководство по использованию API-ключа в качестве временной замены после исчерпания лимитов: Для решения проблем снижения качества ответов GPT-6-Astra и исчерпания лимитов ChatGPT/Codex предлагается 5-шаговый метод диагностики причин деградации модели, а также комплексное решение с использованием официального API-ключ через сервис-прокси API, регулировкой интенсивности вызова модели и повышением частоты попаданий в контекстное окно.