> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Официальный релей GPT Image 2.6: какие сочетания формата вывода и фона недопустимы?

> Для официального реле GPT Image 2.6 (gpt-image-2.6-sunburst / gpt-image-2.6-flare): только сочетание transparent + jpeg возвращает ошибку 400, gif поддерживает 1-битную прозрачность, а для фона svg требуется opaque.

> [!NOTE]
>
> Эта страница относится к двум моделям **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. Все остальные сочетания работают, но прозрачность обрабатывается по-разному:

| `background` | `png` | `jpeg` | `webp` | `gif` | `svg` |
| - | - | - | - | - | - |
| `transparent` | ✅ полная альфа-прозрачность | ❌ 400 | ✅ полная альфа-прозрачность | ✅ прозрачность в 1 бит | ✅ без фона |
| `opaque` | ✅ сплошной цвет | ✅ сплошной цвет | ✅ сплошной цвет | ✅ сплошной цвет | ✅ белый фон |
| `auto` | ✅ | ✅ | ✅ | ✅ | ✅ |

Измерения выполнены на официальном реле 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"` завершается ошибкой:

```text theme={null}
Transparent background is not supported for JPEG output format
```

Это относится как к `/v1/images/generations`, так и к `/v1/images/edits`. Переключитесь на `png` / `webp` (или `gif` для анимации); `opaque` и `auto` работают с JPEG без проблем.

> [!WARNING]
>
> В нашем тесте эндпоинт редактирования вернул эту ошибку 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`, когда нужен белый фон.

> [!NOTE]
>
> `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.

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

> [card] [Возможности GPT Image 2.6](https://docs.apiyi.com/ru/api-capabilities/gpt-image-2/gpt-image-2-6.md)
>
> SVG, GIF, `complexity` и редактирование по разметке с реальными результатами.

> [card] [Как создавать изображения с прозрачным фоном](https://docs.apiyi.com/ru/faq/image-transparent-background.md)
>
> Формат параметров, требования к prompt и распространённые ошибки при работе с прозрачным фоном.

> [card] [Справочник API генерации изображений по тексту](https://docs.apiyi.com/ru/api-capabilities/gpt-image-2/text-to-image.md)
>
> Все поля для `/v1/images/generations`.

> [card] [Справочник API редактирования изображений](https://docs.apiyi.com/ru/api-capabilities/gpt-image-2/image-edit.md)
>
> `/v1/images/edits` и редактирование нескольких изображений.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.