Перейти к основному содержанию
Эта страница относится к двум моделям GPT Image 2.6 через официальный релей: gpt-image-2.6-sunburst (точная работа) и gpt-image-2.6-flare (быстрые итерации). GPT Image 2.5 / 2 не поддерживают вывод в формате gif или svg, поэтому не применяйте эти правила к ним напрямую.

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

Есть только один жёсткий конфликт: background: "transparent" нельзя использовать вместе с output_format: "jpeg" — запрос возвращает ошибку 400. Все остальные сочетания работают, но прозрачность обрабатывается по-разному: Измерения выполнены на официальном реле GPT Image 2.6 2026-11-12 (quality: "low", n: 1; GIF размером 512×512, 2 кадра; SVG с svg.model: "gpt-4.1-mini"). Полная матрица измерена на gpt-image-2.6-sunburst; jpeg + transparent, gif + transparent и svg + opaque повторно проверены на gpt-image-2.6-flare — результаты совпали.

JPEG — единственный случай ошибки 400

У JPEG нет альфа-канала, поэтому background: "transparent" завершается ошибкой:
Это относится как к /v1/images/generations, так и к /v1/images/edits. Переключитесь на png / webp (или gif для анимации); opaque и auto работают с JPEG без проблем.
В нашем тесте эндпоинт редактирования вернул эту ошибку 400 примерно через 62 секунды (а эндпоинт генерации изображения по тексту — примерно через 19 секунд), поэтому не повторяйте запрос только потому, что он выполняется медленно.

GIF поддерживает прозрачность, но только 1-битную альфа-прозрачность

output_format: "gif" + background: "transparent" работает в версии 2.6 как для генерации изображений по тексту, так и для редактирования изображений. В наших тестах прозрачные пиксели занимали 46%–60% кадра по сравнению с 0% для opaque. Прозрачность GIF основана на палитре: пиксель либо полностью прозрачен, либо полностью непрозрачен, без мягких альфа-границ. Используйте png / webp, если качество краёв имеет значение. Это применимо только к версии 2.6, которая поддерживает вывод в формате GIF; версии 2.5 и более ранние версии не поддерживают вывод в формате GIF.

В SVG нет альфа-канала; opaque добавляет фон

SVG — векторный формат без альфа-канала, в котором по умолчанию используется прозрачный фон:
  • transparent: прямоугольник фона не записывается.
  • opaque: добавляется белый прямоугольник на весь холст, например <rect width="1024" height="1024" fill="#fff" />.
  • auto: в обоих наших тестах auto не записывал фон, поэтому не считайте его эквивалентом opaque; явно передавайте opaque, когда нужен белый фон.
output_format: "svg" поддерживается только на эндпоинте генерации изображений по тексту и требует n: 1 и svg.model. Модель, создающая изображение, определяет окончательную разметку фона, поэтому после изменения svg.model повторно проверьте полученный файл.

auto не фиксирован в значении opaque

Если background не указан, по умолчанию используется auto. auto следует промпту, а не всегда создает сплошной фон:
  • При запросе на обычный белый фон png / jpeg / gif сообщили opaque, альфа-канала не было.
  • При запросе на изолированный объект без фона png / webp / gif / svg сообщили transparent; первые три действительно содержали прозрачные пиксели.
  • При использовании jpeg значение auto принудительно устанавливается в opaque, ошибки не возникает.
Чтобы получать предсказуемый результат, явно передавайте transparent или opaque, а не полагайтесь на auto.

Два связанных ограничения по форматам

  • output_compression применяется только к jpeg / webp.
  • frame_count / frame_duration_ms предназначены только для gif; не передавайте их для PNG, JPEG, WebP или SVG.

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

Возможности GPT Image 2.6

SVG, GIF, complexity и редактирование по разметке с реальными результатами.

Как создавать изображения с прозрачным фоном

Формат параметров, требования к prompt и распространённые ошибки при работе с прозрачным фоном.

Справочник API генерации изображений по тексту

Все поля для /v1/images/generations.

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

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