> ## 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-flare / gpt-image-2.6-sunburst (официальный релей, оплата по token) и gpt-image-2.6-all (обратный маршрут, $0.025/изображение): сравнение по пунктам — тарификация, размер / n / качество, GIF / SVG, прозрачный фон и маски, форматы ответа, скорость и лимиты, а также рекомендации по выбору и ответы на часто задаваемые вопросы.

## Краткий вывод

| Если вам нужно | Выберите |
| - | - |
| **Полное соответствие официальным полям OpenAI**, шесть уровней `quality`, любой допустимый размер, нативное разрешение 2K/4K | Официальные модели: `gpt-image-2.6-flare` (приоритет скорости) / `gpt-image-2.6-sunburst` (приоритет точности редактирования) |
| **Жёсткий предел стоимости**: фиксированная цена \$0.025 за изображение, та же цена для 2K/4K, без зависимости от размера или качества | Реверс: `gpt-image-2.6-all` |
| **Несколько изображений за вызов** (1–4 изображения) или **прямая URL-ссылка на 24 часа** | `gpt-image-2.6-all` |
| **Управление количеством кадров GIF, длительностью каждого кадра и размером каждого кадра** или SVG, в котором фиксируется авторская модель и отдельно указывается стоимость текстовой модели | Две официальные модели 2.6 |
| **Точная дорисовка по маске / слияние нескольких изображений (до 16 изображений) / вывод в WebP / нативное разрешение 4K** | Две официальные модели 2.6 |
| **Недорогие GIF и SVG** без передачи `svg.model` или оплаты услуг авторской модели | `gpt-image-2.6-all` |

> [!NOTE]
>
> На этой странице сравниваются только три модели поколения 2.6. Полное сравнение поколений 2.5 / 2 (`gpt-image-2.5-flare` / `sunburst` / `gpt-image-2` и `gpt-image-2-all` / `gpt-image-2.5-all` / три модели `-vip`) см. в разделе [GPT-image-2.5 / 2: официальные и реверс-модели](https://docs.apiyi.com/ru/api-capabilities/gpt-image-2/vs-gpt-image-2-all.md). `gpt-image-2.6-all` — новая линейка реверс-моделей для 2.6 — **не** переименование `gpt-image-2.5-all`; модели различаются поведением и ограничениями параметров.

## Полная сравнительная таблица

| Параметр | Официальный: `gpt-image-2.6-flare` / `gpt-image-2.6-sunburst` | Релей: `gpt-image-2.6-all` |
| - | - | - |
| **Характер канала** | Прямое подключение к Images API OpenAI; поля, коды ошибок и поведение соответствуют официальной реализации OpenAI | Реверс-инжиниринг веб-версии ChatGPT Images 2.6 |
| **Тарификация** | **По фактическому использованию token**: \$5 за 1 млн текстовых входных token / \$8 за 1 млн входных image token / \$30 за 1 млн выходных image token | **За запрос**: \$0.025 за image, одинаковая цена для 2K/4K; изображения `n` тарифицируются за каждое image |
| **Стоимость image** | Зависит от `quality`, `size` и количества reference image; примерно \$0.006–\$0.21 при 1K (справочные значения; определяющей является ваша `usage`) | Фиксированная цена \$0.025 за image (`n=4` стоит \$0.10) |
| **Рекомендуемые эндпоинты** | `/v1/images/generations` + `/v1/images/edits` | `/v1/images/generations` + `/v1/images/edits` |
| **Количество image за вызов, `n`** | 1 image (для большего количества отправляйте параллельные запросы на стороне клиента) | 1–4 (`n=5` и больше возвращает 400) |
| **`size` (нативный уровень)** | Любой допустимый размер: обе стороны кратны 16, соотношение сторон ≤3:1, общее количество пикселей 655 360–8 294 400, максимальная сторона 3840; кроме того, доступны 8 предустановок | Максимальная сторона 512–1536 как **любое целое число** (требование кратности 16 отсутствует), соотношение сторон ≤3:1, точный размер результата |
| **`size` (2K / 4K)** | **Нативные пиксели** (2048×2048, 2048×1152, 3840×2160 и т. д.); размеры свыше 2560×1440 OpenAI помечает как экспериментальные | **Сверхвысокое разрешение**: распространённые размеры 2K/4K выдаются точно; несоответствие возвращает 502; ограничение для квадратных изображений — 2880; соотношение 4:1 отклоняется с ошибкой 400 |
| **`quality`** | `auto` / `low` / `medium` / `high` / `xhigh` / `max`, шесть уровней | Только `auto` / `medium` / `high`; `low` / `hd` возвращают 400; на данный момент для трёх уровней нет проверяемой разницы в качестве image |
| **`complexity` (новое в 2.6)** | ✅ Передаётся нативно: `low` / `medium` / `high` (если параметр не указан, используется `high`), отдельная плата не взимается; перед выбором настройки сравните один и тот же prompt на разных уровнях | **Не поддерживается** этим маршрутом |
| **Форматы результата** | `png` / `jpeg` / `webp` / `gif` / `svg` | `png` / `jpeg` / `gif` / `svg`; **WebP возвращает 400** |
| **Прозрачный фон** | `background=transparent` + `png` / `webp`; несовместим с `jpeg` (400); GIF использует 1-битную прозрачность; SVG не добавляет фон | Только `png`: стабильно до 2K, нестабильно при 4K |
| **Управление GIF** | Количество кадров, длительность кадра и размер каждого кадра настраиваются отдельно с учётом ограничения на количество пикселей в спрайт-листе (отдельные кадры 1024² / 2048² не работают) | Количество кадров и длительность задаются точно; **итоговые размеры определяются вышестоящим сервисом**; `output_format=gif` необходимо передавать явно |
| **SVG** | `svg.model` должен указывать модель, использованную для создания, а тарификация text-модели выполняется отдельно; только эндпоинт генерации, `n=1` | `svg.model` не требуется (если передан, игнорируется); плата за text-модель не взимается; `viewBox` следует `size` |
| **Заполнение по маске** | Официальная семантика (PNG с альфа-каналом; по-прежнему используется мягкое управление) | Поддерживается, но **нет гарантии, что изменения затронут только область маски** |
| **Множественные reference image** | До 16 (`image[]`) | В ходе тестирования работают 2 reference image; для большего количества объединяйте их на стороне клиента или редактируйте поэтапно |
| **Формат ответа** | Фиксированный `b64_json` (необработанный base64 без префикса); **`response_format` не поддерживается** — его передача возвращает 400 | По умолчанию `b64_json`; поддерживается `response_format: "url"` (подписанная ссылка на 24 часа; в ответах с url может отсутствовать `size`) |
| **Скорость** | OpenAI сообщает, что версия 2.6 в целом на 50 % быстрее, а `flare` может выполняться всего за 6 с при `low` (лучший случай по данным OpenAI); высокое качество и 2K/4K заметно замедляют обработку | Обычно 10–46 с (1K — 10–22 с, 2K — 12–24 с, 4K — 15–42 с); измеренная хвостовая задержка достигает 198 с |
| **Рекомендуемый тайм-аут клиента** | `low` ≥120 с / `medium` ≥240 с / `high` ≥600 с / `xhigh` ≥300 с / `max` ≥600 с | ≥600 с |
| **Token и группа** | Требуется **Token Pay-as-you-go Priority**; достаточно группы `Default`, а группа `image2Enterprise` для предприятий (1,2x) используется как резервный вариант в часы пиковой нагрузки | Поскольку модель тарифицируется за запрос, достаточно группы `Default`; для вывода через URL дополнительная группа не требуется |
| **Стабильность** | Официальный канал, коды ошибок идентичны кодам OpenAI; в часы пик в группе `Default` иногда возникает 429 | Релей вышестоящего сервиса; при 2K/4K иногда возникает 502, требуется повторная попытка; несоответствие размера приводит к явной ошибке вместо незаметного изменения размеров |
| **Лучше всего подходит для** | Производственных задач, чувствительных к качеству, которым нужны официальные поля и нативные пиксели и которые допускают колебания расходов при тарификации по факту использования | Фиксированной стоимости, пакетной генерации, работы с большими холстами 2K/4K, а также задач с GIF / SVG / несколькими image / URL |

> [!NOTE]
>
> Диапазоны стоимости в таблице основаны на измерениях для поколений 2.5 с одинаковым ценовым уровнем (2026-09-09, UTC+8) и экстраполяции для 2K/4K по количеству пикселей; для официальных моделей 2.6 пока нет общедоступных измерений по уровням, поэтому определяющей является фактическая стоимость ответа (`usage.output_tokens`). Цена 2.6-all за image соответствует вкладке **Цены моделей** и вашему итоговому счёту.

## Модели тарификации и стоимость

На APIYI главное различие между двумя вариантами заключается в **способе учёта использования**: официальные модели тарифицируют потреблённые tokens, а в 2.6-all стоимость ограничена фиксированной ценой за изображение. От этого зависит, какой вариант дешевле для конкретной нагрузки.

### Стоимость изображения при разрешении 1024×1024

| `quality` | Официальная 2.6 (тарификация по tokens) | `gpt-image-2.6-all` |
| - | - | - |
| `low` | ≈\$0.006 (196 tokens по тарифу 2.5 с той же ценой); один замер 2.6 показал 824 tokens ≈ \$0.025 | \$0.025 |
| `medium` | ≈\$0.013 (439 tokens) | \$0.025 |
| `high` | ≈\$0.053 (1,756 tokens) | \$0.025 |
| `xhigh` | ≈\$0.094 (3,122 tokens) | \$0.025 |
| `max` | ≈\$0.211 (7,024 tokens) | \$0.025 |

> [!NOTE]
>
> Цены на модели соответствуют официальному прайс-листу и могут измениться при корректировке цен OpenAI; таблица выше приведена только для справки — актуальные данные указаны на вкладке **Цены на модели** в верхнем меню: [Цены на модели](https://docs.apiyi.com/ru/models/index.md).

### 2K / 4K, несколько изображений, редактирование и SVG

| Сценарий | Официальная 2.6 (тарификация по tokens) | `gpt-image-2.6-all` |
| - | - | - |
| 2048×2048 `medium` / `high` | ≈\$0.21 / ≈\$0.84 (экстраполяция по числу пикселей, не официальная цена) | \$0.025 |
| 2048×1152 `medium` / `high` | ≈\$0.06 / ≈\$0.25 (экстраполяция по числу пикселей) | \$0.025 |
| 3840×2160 (4K) `medium` / `high` | ≈\$0.22 / ≈\$0.87 (экстраполяция по числу пикселей) | \$0.025 |
| 4 изображения по одному prompt | 4 вызова, количество tokens суммируется | 4 × \$0.025 = \$0.10 |
| Редактирование с одним референсным изображением 1024² | Выходные tokens + плата за входные данные (референсное изображение 1024² стоит ≈\$0.0082) | \$0.025/изображение |
| SVG | Сегмент изображения + плата за текст модели, создающей SVG: `gpt-6-luna` ≈\$0.026, `gpt-5.6-terra` ≈\$0.039 | \$0.025 |
| GIF, 512², 2 кадра | ≈\$0.017 | \$0.025 |

> [!WARNING]
>
> **Фиксированной официальной таблицы цен для 2K/4K нет.** OpenAI публикует только справочную цену за изображение 1K, поэтому приведённые выше значения для 2K/4K экстраполированы из цены 1K по соотношению количества пикселей и могут значительно отличаться от фактических; `high` выше 2560×1440 пока относится к экспериментальному уровню. Определяйте фактическую стоимость по `usage.output_tokens` каждого вызова. Для 2.6-all документированная цена составляет \$0.025 за изображение и остаётся такой же при 2K/4K; окончательная сумма указана в вашем счёте. Текущие цены доступны на вкладке **Цены на модели**: [Цены на модели](https://docs.apiyi.com/ru/models/index.md).

**Как быстро выбрать:** если учитывать только выходные tokens, при официальной тарификации \$0.025 соответствуют примерно **833 выходным tokens** — это между уровнями `medium` и `high` поколения 2.5. Поэтому:

* **1K при низком или среднем качестве**: стоимость обоих вариантов одного порядка, а официальный вариант может оказаться дешевле в зависимости от фактического `usage`; однако единственный замер 2.6 (`low`, 824 tokens ≈ \$0.025) показывает, что для 2.6 преимущество уже может быть незначительным, поэтому **не переносите выводы, основанные на цифрах 2.5**.
* **1K на уровне `high` и выше или 2K/4K при среднем или высоком качестве**: фиксированная цена 2.6-all в \$0.025 однозначно выгоднее — при высоком качестве 2K/4K стоимость может различаться на порядок.
* **Редактирование с референсными изображениями**: каждое референсное изображение 1024² в официальном варианте добавляет к стоимости входных данных около \$0.0082 и быстро увеличивает стоимость одного вызова; 2.6-all тарифицируется за изображение, а плата за референсные изображения не суммируется.

> [!TIP]
>
> Перед запуском в эксплуатацию выполните по одному раунду с вашими prompt для каждого варианта и запишите `usage` и задержку: для официального варианта рассчитайте стоимость выходных tokens, а для 2.6-all умножьте количество изображений на цену за единицу. Любой вывод о соотношении цены и производительности применим только к тем prompt, которые вы действительно протестировали.

## Подробные ключевые различия

### 1. `size`: любой допустимый размер + нативные 2K/4K против нативного 1536 + 2K/4K с суперразрешением

**Официальный 2.6** следует официальным правилам размеров; одновременно должны выполняться все четыре условия:

1. Длинная сторона ≤ 3840
2. Обе стороны кратны 16
3. Соотношение сторон ≤ 3:1
4. Общее количество пикселей — от 655,360 до 8,294,400

Доступно 8 предустановленных размеров: `auto`, `1024x1024`, `1536x1024`, `1024x1536`, `2048x2048`, `2048x1152`, `3840x2160`, `2160x3840`. 2K/4K — это **нативные пиксели**, а не увеличение разрешения.

**2.6-all** разделён на два уровня:

* **Нативный уровень**: длинная сторона — 512–1536; любой целочисленный размер выдаётся точно, без требования кратности 16 (`1000x1000`, `1280x720` и `1536x864` проходят), соотношение сторон ≤ 3:1
* **Уровень суперразрешения**: распространённые размеры, такие как `2048x2048`, `2048x1152`, `2048x1536`, `1920x1080`, `3840x2160` и `2880x2880`, выдаются точно; при несовпадении возвращается **502 `size_not_deliverable`**, а размер не подменяется незаметно на другой. Максимальный размер для квадратного изображения — 2880 (`4096x4096` возвращает 502), а соотношение сторон больше 3:1, например `4096x1024`, приводит к ошибке 400

> [!NOTE]
>
> Одно легко упустить из виду: генерация растровых изображений через официальный маршрут имеет **минимальный бюджет пикселей** (около 655,360), поэтому небольшие изображения, например `512x512`, отклоняются; 2.6-all может создавать `512x512` и `512x384`. Для небольших иконок и миниатюр 2.6-all — более гибкий вариант.

### 2. `n`, `quality` и `complexity`: официальные уровни и три уровня с поддержкой нескольких изображений

* **`n`**: официальный маршрут всегда возвращает одно изображение, поэтому для получения нескольких изображений необходимы параллельные запросы на стороне клиента; 2.6-all поддерживает от 1 до 4 изображений, тарифицирует каждое изображение и возвращает ошибку 400 при `n=5`.
* **`quality`**: официальный маршрут предоставляет все шесть уровней (`low` / `medium` / `high` / `xhigh` / `max` / `auto`), обеспечивая официально заявленное управление качеством; 2.6-all принимает только `auto` / `medium` / `high` (`low` / `hd` возвращают ошибку 400), а проверяемых различий в качестве изображений между тремя уровнями в настоящее время не выявлено — **не используйте этот параметр для управления качеством и не рассчитывайте, что он управляет размером**.
* **`complexity`**: параметр, введённый в версии 2.6. Официальный маршрут теперь напрямую поддерживает все три официальных уровня (`low` / `medium` / `high`; если параметр не указан, по умолчанию используется `high`) без дополнительной платы; прежде чем выбрать настройку, сравните результаты для одного и того же prompt. **2.6-all не поддерживает этот параметр**.

### 3. GIF и SVG: управление и стоимость

**GIF**

| Параметр | Официальный маршрут 2.6 | `gpt-image-2.6-all` |
| - | - | - |
| Количество кадров | 2–16, по умолчанию 9 | Диапазон не указан в документации; при тестировании получено точно 4 / 6 / 8 кадров |
| Длительность кадра | 20–2000 мс, по умолчанию 200 мс, округляется до 10 мс | При тестировании получено точно 120 / 150 / 300 мс |
| Размер кадра | Должен быть кратен 16; ограничен допустимым количеством пикселей в листе спрайтов | **`size` не влияет на результат**; итоговые размеры определяются на стороне поставщика |
| Итоговые размеры | Предсказуемы: 512×512 работает при любом количестве кадров; отдельные кадры 1024² / 2048² не поддерживаются | Не гарантируются: при тестировании получены размеры 384×512, 507×506 и 619×623 |
| Эндпоинт редактирования | Поддерживается | В документации показан только эндпоинт генерации; проверьте редактирование GIF самостоятельно |

Официальный маршрут 2.6 создаёт GIF в виде единого листа спрайтов, а затем разрезает его на кадры, поэтому ограничения применяются к листу: самая длинная сторона ≤3840, общее количество пикселей ≤8,294,400, соотношение сторон ≤3:1. Максимальный размер квадратного кадра уменьшается с ростом количества кадров: 960×960 для 2–9 кадров, 816×816 для 10–12 кадров и 720×720 для 13–16 кадров. При превышении допустимого количества пикселей возвращается ошибка 400; значение `frame_count`, равное 1 или 17, не вызывает ошибку, но приводит к использованию значения по умолчанию — 9 кадров / 1,8 секунды, поэтому проверяйте фактическое количество кадров с помощью `ffprobe`.

**SVG**

| Параметр | Официальный маршрут 2.6 | `gpt-image-2.6-all` |
| - | - | - |
| Обязательные поля | `output_format="svg"` + `svg.model` (модель для создания) | Только `output_format="svg"` |
| Дополнительная стоимость | Использование модели для создания тарифицируется по ставкам входных / выходных данных выбранной текстовой модели (примерно \$0.001–\$0.013 за изображение) | Нет; \$0.025 за изображение |
| Эндпоинт / количество изображений | Только генерация, `n=1`; эндпоинт редактирования не поддерживает SVG | Генерация; `viewBox` определяется параметром `size` |
| Размер | `viewBox` определяется параметром `size`; общедоступных измерений для больших размеров пока нет | `viewBox` протестирован до 8192; соотношение сторон 4:1 не ограничено пределом 3:1 для растровых изображений |

> [!WARNING]
>
> При использовании официального маршрута 2.6 необходимо самостоятельно указать модель для создания (`svg.model`) — если её не указать, запрос вернёт ошибку 400 `SVG generation requires 'svg.model'`, — а стоимость состоит из двух частей: за изображение и за текст. Для 2.6-all параметр `svg.model` не требуется и игнорируется, если его передать. Выбирайте официальный маршрут, если вам нужна детализация стоимости текста SVG; выбирайте 2.6-all, если вам важны низкая стоимость и меньшее количество зависимостей между полями.

### 4. Формат ответа: `b64_json` и `b64_json` + URL

* **Официальный 2.6**: всегда возвращает `b64_json` (необработанный base64, без префикса `data:`) и **не принимает `response_format`** — при передаче этого параметра возвращается ошибка 400. Чтобы получить URL, необходимо сохранить изображение в собственном хранилище.
* **2.6-all**: по умолчанию возвращает `b64_json`; также можно явно передать `response_format: "url"`, чтобы получить подписанную ссылку, действительную в течение 24 часов. Обратите внимание: **в ответах с URL поле `size` может отсутствовать**; оно присутствует только в ответах с b64. После истечения срока действия URL сгенерируйте изображение повторно и своевременно разместите его в своём хранилище.

В обоих маршрутах `b64_json` не содержит префикса `data:`, поэтому можно использовать общую логику декодирования.

### 5. Редактирование: маска, несколько изображений и разметка

| Возможность | Официальная версия 2.6 | `gpt-image-2.6-all` |
| - | - | - |
| Дорисовка по маске | Официальные требования: PNG, альфа-канал, размер менее 4 МБ; при этом маска служит лишь ориентиром и не гарантирует соблюдения её границ с точностью до пикселя | Поддерживается, но нет гарантии, что изменится только область маски; для сложных правок точно укажите в prompt, что изменить, а что сохранить |
| Референсы из нескольких изображений | До 16 (`image[]`); обозначайте их в prompt как «изображение 1» / «изображение 2» | При тестировании работают 2 референса; если их больше, сначала объедините изображения или выполняйте редактирование поэтапно |
| Редактирование с размером `auto` | Определяется действующими правилами обработки входных данных | Выходное изображение приводится к разрешению около 1,57 Мп с сохранением соотношения сторон исходного изображения; исходные размеры в пикселях не гарантируются |
| Редактирование с помощью разметки | Новая возможность в версии 2.6, но передача разметки зависит от маршрута — проверьте её в своей группе | Для этого маршрута не документировано |

### 6. Скорость, тайм-ауты и стабильность

**Разделяйте официальные заявления и результаты измерений:**

* Официально для 2.6: OpenAI сообщает, что генерация в целом выполняется на 50% быстрее, а `flare` достигает 6 секунд при `low`. Это наилучший результат OpenAI, а не гарантия для каждого запроса. На сайте пока нет измерений 2.6 по уровням тарифа; в качестве ориентира используйте показатели 2.5 для того же уровня тарифа: `2.5-flare` при разрешении 1024² показал 10 с при `low` / 21 с при `high` / 45 с при `max`, а `2.5-sunburst` — 14 / 42 / 142 с. Высокое качество и разрешения 2K/4K заметно увеличивают время генерации.
* 2.6-all: обычно 10–46 с (1K — 10–22 с, 2K — 12–24 с, 4K — 15–42 с), но измеренная пиковая задержка достигала 198 с, поэтому настройте тайм-ауты клиентов на 600 с.

Оба маршрута **синхронные**: идентификатора задачи нет, поэтому при отключении клиента результат теряется, хотя запрос всё равно тарифицируется. Увеличьте тайм-ауты, а также лимиты времени выполнения для обратных прокси и бессерверных сред.

**Параллельные запросы и стабильность:**

* Официальный маршрут проходит через OpenAI, по умолчанию поддерживает около 100 RPM и динамически адаптируется к общей параллельной нагрузке платформы; группа `Default` иногда возвращает 429 в периоды пиковой нагрузки, а переход на корпоративную группу `image2Enterprise` (1,2x) может помочь справиться с нагрузкой.
* 2.6-all прошёл тестирование при параллельной нагрузке 12×2, 16×1 и 8 запросов на разрешении 1K без ошибок 429; нагрузка на 2K/4K не тестировалась, поэтому начните с 4–8 параллельных запросов и следите за пиковой задержкой. На 2K/4K иногда возвращается 502 `size_not_deliverable`; повторите запрос или выберите поддерживаемый размер.
* Для обоих маршрутов дважды повторяйте запросы при ошибках 5xx и тайм-аутах, используя экспоненциальную задержку между попытками; при ошибке 429 увеличивайте задержку.

## Когда выбирать каждый вариант

> [card] Выбирайте официальный gpt-image-2.6-flare / sunburst
>
> * **Поля и поведение должны в точности совпадать с OpenAI**: существующие проекты на официальном SDK или с официальными полями можно перенести без изменений
> * **Нужны все шесть уровней `quality`**, особенно качество готовых материалов на уровне `xhigh` / `max`
> * **Нужны изображения с исходным разрешением 2K/4K** для печати, тонких текстур или высокой детализации
> * **Нужны точные маски, объединение нескольких изображений (16 изображений) или вывод в WebP**
> * **Нужны настраиваемый размер каждого кадра GIF или SVG с указанной авторской моделью и подробной разбивкой стоимости**
> * Вы готовы к колебаниям расходов по факту использования ради стабильности официального маршрута

> [card] Выбирайте gpt-image-2.6-all (reverse)
>
> * **Нужна фиксированная стоимость**: \$0.025 за изображение, одинаковая для 2K/4K, легко планировать бюджет
> * **Пакетное производство**, инфографика, маркетинговые материалы, изображения для электронной коммерции
> * **Совместимость с большим холстом 2K/4K**: вам нужен холст большего размера без детализации в исходном разрешении
> * **Недорогие GIF/SVG**: без `svg.model` и без платы за текстовую модель
> * **Несколько изображений за вызов (1–4) или прямой URL со сроком действия 24 часа**
> * Быстрые итерации и фирменный стиль ChatGPT в исходном разрешении до 1536 (с fingerprint)

## Настройки клиента

| Параметр | Официальный вариант 2.6 | `gpt-image-2.6-all` |
| - | - | - |
| **Тайм-аут клиента** | `low` ≥120 с, `medium` ≥240 с, `high` ≥600 с, `xhigh` ≥300 с, `max` ≥600 с | ≥600 с |
| **Стратегия повторных попыток** | Дважды применять экспоненциальную задержку при ошибках 5xx и тайм-аутах; при 429 увеличивать задержку | То же, но при 502 сначала менять размер `size_not_deliverable` |
| **Параллельные запросы** | По умолчанию около 100 RPM; в пиковые периоды переключаться на `image2Enterprise` | Начните с 10–16 параллельных запросов для 1K; 4–8 для 2K/4K |
| **Обработка ответа** | Всегда использовать b64 и декодировать самостоятельно; не отправлять `response_format` | b64 или url; оперативно размещать ответы url на собственном хостинге; в них может отсутствовать `size` |
| **Проверка размера** | Проверять соответствие четырём официальным ограничениям | Использовать `size` из ответа и фактические размеры изображения; явное несоответствие размера приводит к ошибке 502 |
| **Учёт стоимости** | Записывать `usage.output_tokens` и пересчитывать по ставке \$30 за 1 млн | Записывать количество возвращённых изображений × \$0.025 |
| **Тип токена** | Должен быть **Priority с оплатой по факту использования** | Модель с оплатой за запрос; достаточно группы `Default` |

```python theme={null}
import base64
import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["APIYI_API_KEY"],
    base_url="https://api.apiyi.com/v1",
    timeout=600,
)

# Official 2.6: six quality tiers + native sizes
official = client.images.generate(
    model="gpt-image-2.6-flare",
    prompt="Minimalist specialty coffee poster, product and soft morning light in focus, with space reserved for a headline",
    size="2048x1152",
    quality="high",
)

# 2.6-all: flat per-image price; pass response_format explicitly when you need a direct URL
reverse = client.images.generate(
    model="gpt-image-2.6-all",
    prompt="Minimalist specialty coffee poster, product and soft morning light in focus, with space reserved for a headline",
    size="2048x1152",
    quality="medium",
    response_format="b64_json",
)

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

with open("coffee-reverse.png", "wb") as f:
    f.write(base64.b64decode(reverse.data[0].b64_json))
```

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

> [accordion] Можно ли переключаться между двумя каналами, меняя только имя модели?
>
> Для базовой генерации изображений по тексту и редактирования можно использовать общую кодовую базу, но **семантика параметров не полностью совпадает**, поэтому при переключении один раз выполните нормализацию:
>
> * `size`: официальный маршрут требует размеров, кратных 16, и соблюдения диапазона общего числа пикселей; нативный режим 2.6-all принимает любое целое число, а 2K/4K использует сверхразрешение
> * `quality`: шесть уровней на официальном маршруте; 2.6-all принимает только `auto` / `medium` / `high`
> * `response_format`: передача этого параметра на официальном маршруте возвращает 400; 2.6-all принимает `url`
> * `n`: официальный маршрут возвращает 1 изображение; 2.6-all возвращает 1–4
> * GIF / SVG: разные требования к полям и ограничения
>
> Ни на одном из маршрутов `b64_json` не содержит префикс `data:`, поэтому логику декодирования можно использовать повторно.

> [accordion] Почему 2.6-all настолько дешевле? Страдает ли качество изображений?
>
> Причин три: **тарификация за изображение** охватывает 1K–4K (официальный маршрут учитывает tokens, и их объём резко растёт при высоком качестве и больших размерах); **2K/4K использует сверхразрешение**, а не нативные пиксели; кроме того, доступно **меньше уровней качества**. Два маршрута по-разному позиционируются по качеству: 2.6-all сохраняет нативное качество и характерные особенности веб-версии ChatGPT при размерах до 1536, а официальный маршрут использует нативные уровни качества официального API. Публичного слепого тестирования на одинаковых промптах нет, поэтому мы не объявляем победителя — обработайте свои материалы через оба маршрута и сравните.

> [accordion] Когда необходимо использовать официальный маршрут?
>
> Выбирайте официальный `gpt-image-2.6-flare` / `sunburst`, если вам требуется что-либо из следующего: точное соответствие официальным полям OpenAI, все шесть уровней `quality` (включая `xhigh` / `max`), нативные пиксели 2K/4K, точные маски, объединение нескольких изображений (до 16), вывод в WebP, управляемый размер каждого кадра GIF или SVG с явно указанной моделью создания и отдельно указанной стоимостью текстовой модели.

> [accordion] Когда стоит предпочесть 2.6-all?
>
> Ограниченная стоимость, пакетная генерация, поддержка больших холстов 2K/4K, недорогие GIF / SVG, 1–4 изображения за вызов, прямой URL со сроком действия 24 часа или просто быстрая итеративная работа с черновиками — во всех этих случаях 2.6-all по цене \$0.025 за изображение выгоднее. Помните, что 2K/4K здесь использует сверхразрешение: большее изображение не означает больше деталей.

> [accordion] 2K/4K: нативные пиксели или сверхразрешение?
>
> **Нативная детализация, качество для печати, строгое требование 4K**: выбирайте официальный маршрут с нативными пикселями, учитывая, что тарификация по tokens заметно дороже. **Вам просто нужен холст большего размера** (плакаты, большие экраны, длинные изображения для электронной торговли) при ограниченной стоимости: выбирайте режим сверхразрешения 2.6-all — распространённые размеры 2K/4K выдаются точно; если важно качество, используйте нативный режим с размерами не более 1536.

> [accordion] Всегда ли запрос 2K/4K в 2.6-all выполняется успешно?
>
> Не всегда. Распространённые размеры (`2048x2048`, `2048x1152`, `2048x1536`, `3840x2160`, `2880x2880` и другие) выдаются точно; квадратные изображения со стороной более 2880, соотношения сторон 4:1 и некоторые запросы 4K с прозрачным фоном завершаются ошибкой (502 `size_not_deliverable` или 400). Проверяйте `size` в ответе и фактические размеры изображения, а при ошибке меняйте размер или повторяйте запрос.

> [accordion] Можно ли задать итоговые размеры GIF?
>
> Официальный маршрут позволяет управлять размером каждого кадра (кратным 16, в пределах лимита листа спрайтов); 2.6-all **не позволяет** — `size` не влияет на GIF, гарантируются только число кадров и длительность, а итоговые размеры в пикселях определяет вышестоящий сервис. Чтобы задать фиксированные размеры GIF сейчас, измените размер или обрежьте файл на стороне клиента.

> [accordion] Как выбрать между двумя маршрутами для SVG?
>
> Если нужно явно указать модель создания, обеспечить соответствие официальным полям OpenAI и вы готовы к отдельной тарификации текстовой модели, выбирайте официальный маршрут (необходимо передать `svg.model`, иначе будет ошибка 400). Если нужны низкая стоимость, меньше зависимостей между полями и большой `viewBox`, выбирайте 2.6-all (`svg.model` не требуется, \$0.025 за изображение).

> [accordion] Можно ли использовать параметр complexity?
>
> `complexity` — параметр управления планированием, добавленный вышестоящим сервисом для версии 2.6. Официальный маршрут теперь напрямую передаёт все три официальных уровня без отдельной платы, хотя более высокие уровни могут увеличивать задержку; **2.6-all его не поддерживает**. Сравните результаты для одного и того же prompt, прежде чем выбирать уровень для рабочей среды.

> [accordion] Можно ли использовать оба канала одновременно для переключения при сбоях?
>
> Да — и мы рекомендуем это делать. Распространённая схема: выбрать один маршрут основным по стоимости или пропускной способности, а другой — резервным. Переключайтесь на 2.6-all, когда официальная группа `Default` возвращает 429 в пиковые часы, или на официальный маршрут, когда 2.6-all выдаёт ошибку из-за политики в отношении контента или размера. Оба маршрута используют `/v1/images/generations` и `/v1/images/edits`, поэтому достаточно один раз нормализовать поля ответа и параметры на уровне бизнес-логики.

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

* [Обзор официального релея GPT-Image-2.6 / 2.5 / 2](https://docs.apiyi.com/ru/api-capabilities/gpt-image-2/overview.md) - Полная документация по интеграции пяти официальных моделей
* [Новые возможности GPT Image 2.6](https://docs.apiyi.com/ru/api-capabilities/gpt-image-2/gpt-image-2-6.md) - `complexity`, SVG, GIF, редактирование по разметке и интерактивная среда
* [Обзор GPT-Image-2.6-All](https://docs.apiyi.com/ru/api-capabilities/gpt-image-2-all/gpt-image-2-6-all.md) - Все параметры, размеры и коды ошибок для обратного маршрута 2.6
* [GPT-image-2.5 / 2: сравнение официального и обратного маршрутов](https://docs.apiyi.com/ru/api-capabilities/gpt-image-2/vs-gpt-image-2-all.md) - Сравнение моделей предыдущего поколения
* [Несовместимости формата вывода и фона](https://docs.apiyi.com/ru/faq/gpt-image-output-format-background.md) - Матрица совместимости прозрачного фона с png / jpeg / webp / gif / svg для официальной модели 2.6
* [Как выбрать уровень усилий рассуждения для SVG](https://docs.apiyi.com/ru/faq/gpt-image-svg-reasoning-effort.md) - Модели для создания SVG и `svg.reasoning.effort` для официального SVG
* [Основы API изображений и рекомендации](https://docs.apiyi.com/ru/api-capabilities/image-api-best-practices.md) - Тайм-ауты, разрывы соединения и повторные попытки
* [Цены на модели](https://docs.apiyi.com/ru/models/index.md) - Актуальные цены на две официальные модели и 2.6-all


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