Генерация изображений GPT-Image-2.5-VIP

GPT-Image-2.5-VIP: генерация/редактирование изображений

Модель генерации изображений GPT с обратной инженерией gpt-image-2-vip (линейка Adobe, Firefly) и её версии gpt-image-2.5-flare-vip / gpt-image-2.5-sunburst-vip. Фиксированная стоимость — $0.03 за изображение. Поддерживает 30 явных размеров (10 соотношений × 3 уровня разрешения: 1K / 2K / 4K). Использует тот же формат вызова, что и gpt-image-2-all. Около 90–150 с на изображение — для рабочих нагрузок, которым требуются фиксированные размеры выходных данных.

Параметр size снова доступен (обновлено 2026-07-22): при явной передаче size теперь размеры вывода фиксируются, как и ожидается, а справочная таблица из 30 размеров на этой странице снова действует. Примечание: size работает только на эндпоинтах /v1/images/generations и /v1/images/edits — чат-эндпоинт /v1/chat/completions не поддерживает параметр size, поэтому генерация изображений через chat не может фиксировать размеры. За актуальным статусом см. раздел Живые обновления.

Все Image API — синхронные: здесь нет ID задачи для опроса, и если ваш клиент отключится, результат будет потерян, а запрос все равно будет тарифицироваться. Задайте для этой модели timeout с запасом; см. Основы и лучшие практики Image API.

Обзор

gpt-image-2.5-vip (псевдоним gpt-image-2.5-sunburst-vip), gpt-image-2.5-flare-vip и предыдущего поколения gpt-image-2-vip — это модели APIYI для генерации изображений GPT, созданные методом обратной инженерии на линейке Adobe (Firefly) — высококачественная обратная линейка GPT-Image 2.5, а не низкокачественный апскейлинг. Та же фиксированная цена $0.03 за изображение, что и у gpt-image-2.5-all, и идентичный формат запросов и ответов — единственное существенное отличие заключается в том, что vip принимает поле size с 30 распространёнными размерами (10 соотношений сторон × 3 уровня разрешения: 1K Быстрый / 2K Рекомендуемый / 4K Детальный), включая 4K.

🎨 Позиционирование: используйте gpt-image-2.5-vip, когда необходимо зафиксировать размер результата (ключевые изображения для интернет-магазина, шаблоны постеров, миниатюры видео, обои 4K и т. д.). Просто замените поле model на gpt-image-2.5-vip и добавьте поле size — все остальные строки кода остаются идентичными gpt-image-2.5-all.

Три модели -vip относятся к одному семейству: gpt-image-2.5-vip (псевдоним gpt-image-2.5-sunburst-vip), gpt-image-2.5-flare-vip и предыдущего поколения gpt-image-2-vip используют одну и ту же обратную линейку Adobe с идентичными ценой ($0.03 за изображение, за вызов), группами (Default / image2_OSS / svip), эндпоинтами и форматом вызовов — замените model, чтобы переключиться. flare-vip работает быстрее и создаёт более мягкое изображение; sunburst-vip обеспечивает более высокое качество и точность редактирования, визуально приближаясь к gpt-image-2-vip. Ограничения параметров и измеренные различия приведены ниже, в разделе «Сравнение трёх моделей -vip».

API преобразования текста в изображение

/v1/images/generations — текстовый промпт + size для явного указания размеров результата.

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

/v1/images/edits — multipart-загрузка с инструкциями по редактированию и объединению.

Позвольте AI-агенту выполнить интеграцию

Если вы разрабатываете с помощью Codex / Claude Code / Cursor, скопируйте приведённый ниже промпт и передайте его своему агенту. Сначала он получает текстовую версию этой страницы (добавьте .md к любому URL документации), а затем пишет код в используемом в вашем проекте стеке — тайм-аут, отображение base64, сжатие загружаемых файлов и 30 допустимых значений size уже включены в требования.

Поручите агенту, работающему с кодом, интегрировать или устранить неполадки text-to-image и редактирования изображений в серии gpt-image-2.5-vip. Скопируйте и вставьте этот текст в Codex, Claude Code, Cursor и аналогичные инструменты.

От каких проблем избавляет этот промпт

Требование	Предотвращаемая проблема
Тайм-аут увеличен до 360 с	Стандартный тайм-аут распространённых HTTP-клиентов составляет 30–60 с, из-за чего запрос прерывается, пока сервер штатно продолжает генерацию, — отключённый запрос всё равно тарифицируется. См. Основные сведения об API изображений и рекомендации
Явно передавать `response_format`	Значение по умолчанию уже менялось; без него необходимо обрабатывать обе формы: `url` и `b64_json`
`size` ограничен 30 значениями	Любое значение за пределами таблицы переписывается в другой размер; полноширинный знак умножения или заглавная X недопустимы
`quality` — до `high`, но не `n`	`xhigh` / `max` отклоняются; 2.5 `high` равно только `gpt-image-2-vip` `medium`; при отправке `n` со значением 3 выставляется счёт за 3 изображения, но возвращается 1
Читать `error.message` при ответе 429	Отклонённые параметры и перегрузка upstream используют один и тот же код 429, но требуют разной обработки
Сжимать перед загрузкой	Фотографии с телефонов обычно имеют размер 4–5 МБ, а кодирование base64 дополнительно увеличивает их размер примерно на 33 %. См. Сжатие изображений и выходное разрешение

Основные различия по сравнению с `gpt-image-2-all`

gpt-image-2-vip и gpt-image-2-all — это каналы с обратной инженерией, с одинаковой ценой и одинаковым кодом вызова. Они взаимозаменяемы — замените поле model в том же запросе, и поведение в основном будет идентичным. Различия:

Параметр	`gpt-image-2-all`	`gpt-image-2-vip`
Канал	Веб-версия ChatGPT с обратной инженерией	Линейка Adobe с обратной инженерией (Firefly)
Цена	$0.03 / изображение	$0.03 / изображение (единая цена для всех размеров)
Параметр `size`	❌ Не поддерживается (укажите в промпте)	✅ 30 размеров, включая 4K
4K (например, `3840x2160`)	❌	✅ Уровень детализации 4K
Время генерации	~30–60 секунд	~90–150 секунд (сопоставимо с официальным `gpt-image-2`)
Параметр `quality`	❌ Не поддерживается	✅ `auto` / `low` / `medium` / `high` (измерено на всех трёх моделях -vip, это не является обязательством); `xhigh` / `max` ❌
Эндпоинты	`/images/generations` + `/images/edits`	Как слева (идентичны)
Формат ответа	`b64_json` (по умолчанию, необработанный base64 без префикса) / `url` (явно указан `response_format`)	Как слева
Лучше всего подходит для	Управление через промпт, размер не имеет значения	Когда нужен фиксированный размер результата (включая 4K)

Решение в одной строке: не нужен строгий размер, нужен самый быстрый результат → gpt-image-2-all; нужен фиксированный размер или 4K → gpt-image-2-vip; нужен параметр quality или строгое соответствие полей OpenAI-API → используйте официальный gpt-image-2.

Сравнение трёх моделей -vip (измерения от 2026-09-09)

Сравнение в трёх направлениях по 253 запросам в одном и том же канале и с одним и тем же token с изменением только имени модели, а также 26 последовательных граничных вызовов. Контракт идентичен в каждой ячейке; различаются только строки ниже. quality и прозрачный фон ранее отклонялись gpt-image-2-vip, а теперь принимаются — это поведение канала, а не обязательство; ориентируйтесь на фактический ответ.

Параметр	`gpt-image-2-vip`	`gpt-image-2.5-flare-vip`	`gpt-image-2.5-sunburst-vip` (псевдоним `gpt-image-2.5-vip`)
Позиционирование	Предыдущее поколение, сохраняет самый высокий уровень token	2.5 с приоритетом скорости	2.5 с приоритетом качества и редактирования
Цена / группы	$0.03 за изображение, за вызов; `Default` / `image2_OSS` / `svip`	То же	То же
`quality`	✅ `auto` / `low` / `medium` / `high`; `xhigh` / `max` ❌	То же	То же
Выходные token (2048×1152)	низкий 157 / средний 1 413 / высокий 5 650	низкий 157 / средний 367 / высокий 1 413	То же, что у flare-vip
Соответствие уровней	—	2.5 `high` = 2-vip `medium`; самый высокий уровень 2.5 составляет четверть `high` 2-vip	То же, что у flare-vip
`size` по умолчанию	2048×2048	1024×1536, книжная ориентация	2048×2048
30 предустановленных размеров	30/30 — точное соответствие пикселям	30/30	30/30
`size` вне предустановок	Без ошибки: размеры, кратные 16, проходят без изменений, остальные выравниваются до 16 (`1920x1080` → 1920×1088), размеры меньше допустимых увеличиваются до минимального значения стороны (`512x512` → 816×816)	То же	То же
`mask`	⚠️ Принимается, но выполняется регенерация всего изображения; на реальных фотографиях соотношение изменений внутри и снаружи ≈1, три запуска	То же	То же
`background: "transparent"`	✅ Alpha PNG	✅ Промпты с одним объектом дают полностью прозрачные углы	✅ То же, что у flare-vip
`output_format: "jpeg"`	Молча игнорируется, возвращается PNG	То же	То же
`n`	Возвращает 1 изображение, не отправляйте	То же	То же
`response_format: "url"`	✅	✅	✅
Эндпоинт редактирования	Для одного изображения сохраняет размер входного изображения; для нескольких изображений используется размер первого изображения	То же	То же
Качество (визуально, шесть промптов одинакового размера)	Базовый уровень	Мягче, меньше декоративных деталей	Близко к 2-vip
Задержка 1024² (последовательная)	~90–150 с	22–138 с	37–120 с

Как выбрать: для повседневной генерации изображений из текста по умолчанию используйте gpt-image-2.5-vip; для скорости выбирайте gpt-image-2.5-flare-vip; для самого высокого уровня token выбирайте gpt-image-2-vip с high. Ни одна из трёх моделей не выполняет точный inpainting по маске и не принимает xhigh / max; для этого используйте официальный GPT-Image-2.5 / 2. Размер по умолчанию ранее менялся на стороне upstream, поэтому всегда явно передавайте size, чтобы зафиксировать его.

Основные возможности

Фиксированный размер вывода

Поле size поддерживает 30 распространенных размеров — hero-изображения для e-commerce, шаблоны постеров, обои 4K — все выводится с точным числом пикселей.

4K с высоким разрешением

Тариф 4K Detail охватывает 2880×2880 / 3840×2160 / 3840×1632 и т. д., подходит для крупных материалов.

Единая стоимость для всех размеров

1K / 2K / 4K стоят $0.03 за image — без надбавки за 4K.

Тот же формат вызова, что и -all

Структура запроса, поля и форма ответа идентичны gpt-image-2-all — переключайте модели, меняя только строку model.

Высококачественный рендеринг текста

Стабильный рендеринг китайского/английского текста, вывесок и текста для постеров — идеально для инфографики и маркетинговых материалов

Поддержка китайских prompt

Нативное понимание китайских описаний без перевода

Редактирование на естественном языке

Редактируйте с помощью диалоговых описаний, маски не требуются, поддерживается многораундовая итерация

Поддержка стандартных эндпоинтов

Совместимо со стандартными эндпоинтами OpenAI Images API /images/generations и /images/edits

Тарификация

Модель	Тарификация	Цена	Результат
`gpt-image-2-vip`	За вызов	$0.03 / изображение	1 изображение за вызов; поле `size` фиксирует размер выходного изображения
`gpt-image-2.5-flare-vip`	За вызов	$0.03 / изображение	GPT-Image 2.5 с приоритетом скорости; тот же набор параметров, что и у `-vip` (`quality` до `high`)
`gpt-image-2.5-sunburst-vip` (псевдоним `gpt-image-2.5-vip`)	За вызов	$0.03 / изображение	GPT-Image 2.5 с приоритетом качества и редактирования; тот же набор параметров, что и у flare-vip

Примечания по тарификации:

Фиксированная цена $0.03 за изображение для всех 30 размеров — без дополнительной платы за 4K Detail
За неудачные запросы плата не взимается (ошибки авторизации, ошибки проверки параметров)
Для N изображений вызывайте API N раз параллельно

Настройка группы

gpt-image-2-vip находится в группе Default — дополнительная группа не требуется. В обратном канале сейчас стабильно доступен ресурс, поэтому сценарий с резервной группой для предприятий, как у официального релея gpt-image-2, не предусмотрен.

Модель	Группа	Примечания
`gpt-image-2-vip`	`Default`	Обратная линия Adobe (Firefly), фиксированная цена $0.03/изображение, ~90–150 с
`gpt-image-2-vip`	`image2_OSS`	Коэффициент 1x (без надбавки), детерминированный вывод URL — при нагрузке на группу по умолчанию никогда не выполняется переход на base64
`gpt-image-2.5-flare-vip` / `gpt-image-2.5-sunburst-vip` / `gpt-image-2.5-vip`	`Default` / `image2_OSS` / `svip`	В точности те же группы, что и у `gpt-image-2-vip`

Нужен детерминированный вывод URL → переключитесь на группу `image2_OSS`

Согласно измерениям, проведённым в июле 2026 года в группе по умолчанию, gpt-image-2-vip (и gpt-image-2-all) возвращают b64_json, если response_format не указан; явно передайте response_format: "url", чтобы получить URL изображения. Формат вывода группы по умолчанию не гарантируется — исторически по умолчанию использовался url с переходом на b64_json при нагрузке, а в разных версиях канала формат менялся. Если ваш бизнес зависит от вывода URL (запись URL непосредственно в базу данных, отображение во frontend по URL, base64 неприемлем), переключите группу своего токена на image2_OSS — группу, специально предназначенную для детерминированного вывода URL, с коэффициентом 1x (без надбавки), действующим для обеих обратных моделей gpt-image-2-vip и gpt-image-2-all. Она гарантирует, что ответ всегда содержит URL изображения и никогда не переключается на base64.

Экран создания токена: сначала выберите режим тарификации pay-as-you-go, группу image2_OSS (коэффициент 1x), группу с выводом URL изображений, подходящую для gpt-image-2-all и gpt-image-2-vip — Token creation: set billing mode to "pay-as-you-go first" and pick the image2_OSS group (1x) — use it when you need deterministic URL output

Расширенная настройка (если вы также используете gpt-image-2-all и официальный релей gpt-image-2): если ваш токен охватывает все три модели, задайте приоритет групп токена следующим образом:

Первый приоритет: image2Enterprise (корпоративная группа с коэффициентом 1.2x, выделенный стабильный канал для официального релея)
Резервная группа по умолчанию: Default (обе обратные модели находятся здесь и направляются по модели)

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

📖 О группе image2Enterprise: /en/live/2026-04/image2-enterprise-stable

Технические характеристики

Атрибут	Значение
Название модели	`gpt-image-2-vip`; версии 2.5 `gpt-image-2.5-flare-vip` / `gpt-image-2.5-sunburst-vip` (псевдоним `gpt-image-2.5-vip`)
Тип канала	Официальный канал с обратной инженерией (линейка Adobe, Firefly)
Тарификация	$0.03 / изображение, за вызов (фиксированная для всех размеров)
Время генерации	`gpt-image-2-vip` ~90–150 секунд; для моделей 2.5 при последовательных запусках в разрешении 1024² измерялось 22–140 с, с большим разбросом. Планирование параллельных запросов в пределах 500 RPM не требуется. Если вы получили `429`, сначала ознакомьтесь с `error.message`: отклонённый параметр (`quality must be one of…`) требует только исправления параметра; `当前分组上游负载已饱和` (перегрузка upstream) возникает время от времени — повторите запрос с экспоненциальной задержкой, уточните в поддержке статус модели или проверьте оперативные обновления
Параметр `size`	✅ 30 размеров: 10 соотношений × 3 уровня разрешения (1K Быстрый / 2K Рекомендуемый / 4K Детализация)
Поддержка 4K	✅ Уровень 4K Детализация (например, `3840x2160` / `2880x2880`)
Параметр `quality`	Все три ✅ `auto` / `low` / `medium` / `high` (измерено 2026-09-09, поведение канала, не является обязательством); `xhigh` / `max` ❌; в 2.5 то же название уровня соответствует на один шаг меньшему количеству tokens (см. таблицу выше)
Параметр `mask`	⚠️ Принимается всеми тремя моделями, но не гарантируется обработка только области маски (на реальных фотографиях измерялась регенерация всего изображения); для точного инпейтинга используйте официальные модели
Прозрачный фон	✅ Все три возвращают PNG с альфа-каналом для `background: "transparent"` (не является обязательством)
Значение `size` по умолчанию	`gpt-image-2-vip` / sunburst-vip 2048×2048, flare-vip 1024×1536; меняется upstream, ориентируйтесь на фактический ответ
Параметр `n`	❌ Не поддерживается, одно изображение за вызов
Формат ответа по умолчанию	`b64_json` (необработанный base64, без префикса `data:`, проверено 2026-07; всегда явно передавайте `response_format`)
Необязательный формат	`url` (ссылка с ускорением R2 CDN, срок действия ~1 день, требует явной передачи `response_format: "url"`)
Промпты на китайском языке	✅ Поддерживаются изначально
Возможности	Преобразование текста в изображение, редактирование одного изображения, объединение нескольких изображений, редактирование на естественном языке

⏰ Срок действия URL изображения: ~1 день (по умолчанию)Поле url в ответе в режиме url представляет собой ссылку R2 CDN, которая истекает примерно через 24 часа — запросы после этого будут возвращать ошибку 404. Для изображений, которые требуется хранить длительное время, как можно скорее после генерации скачайте их и сохраните в собственном хранилище либо используйте формат ответа b64_json.

Эндпоинты

gpt-image-2-vip совместим с теми же двумя эндпоинтами, что и gpt-image-2-all. Просто замените поле model и при необходимости добавьте size:

Эндпоинт	Назначение	Content-Type	Лучше всего для
`POST /v1/images/generations`	Генерация изображений по тексту	`application/json`	Стандартный формат OpenAI Images API — один и тот же код может работать и с официальным, и с обратным каналом
`POST /v1/images/edits`	Редактирование изображений (одного/нескольких)	`multipart/form-data`	Стандартный формат OpenAI Images API — один и тот же код может работать и с официальным, и с обратным каналом

Используйте OpenAI Images API (/v1/images/generations + /v1/images/edits) по двум причинам:

Более стабильно: upstream-ресурсов для канала Images API больше, поэтому процент успешных вызовов выше
Совместимость с официальным релеем для простого переключения: метод вызова и параметры вроде size полностью совместимы с gpt-image-2 официального релея — если у обратного канала возникнут проблемы с risk-control, просто замените имя model без изменений кода

Также есть чатовый эндпоинт (/v1/chat/completions, больше не рекомендуется) — см. FAQ ниже.

Варианты доменов: api.apiyi.com — основной домен. Вы также можете использовать альтернативные домены шлюза, например b.apiyi.com / vip.apiyi.com. Поведение ответов идентично.

Поддерживаемые размеры (полная таблица из 30 размеров)

gpt-image-2-vip поддерживает 10 соотношений сторон × 3 уровня разрешения = 30 размеров. Передавайте size: "WIDTHxHEIGHT" (строчные символы ASCII x) непосредственно в теле запроса.

1K Быстрый — черновики и недорогие итерации

Соотношение	Название	Пиксели
1:1	Квадрат	`1280x1280`
2:3	Портрет	`848x1280`
3:2	Фото	`1280x848`
3:4	Портрет	`960x1280`
4:3	Стандартный	`1280x960`
4:5	Социальный	`1024x1280`
5:4	Большой	`1280x1024`
9:16	История	`720x1280`
16:9	Широкий	`1280x720`
21:9	Кинематографический	`1280x544`

2K Рекомендуемый — уровень по умолчанию (большинство результатов для продакшена)

Соотношение	Название	Пиксели
1:1	Квадрат	`2048x2048`
2:3	Портрет	`1360x2048`
3:2	Фото	`2048x1360`
3:4	Портрет	`1536x2048`
4:3	Стандартный	`2048x1536`
4:5	Социальный	`1632x2048`
5:4	Большой	`2048x1632`
9:16	История	`1152x2048`
16:9	Широкий	`2048x1152`
21:9	Кинематографический	`2048x864`

4K Детализация — материалы большого формата

Соотношение	Название	Пиксели
1:1	Квадрат	`2880x2880`
2:3	Портрет	`2336x3520`
3:2	Фото	`3520x2336`
3:4	Портрет	`2480x3312`
4:3	Стандартный	`3312x2480`
4:5	Социальный	`2560x3216`
5:4	Большой	`3216x2560`
9:16	История	`2160x3840`
16:9	Широкий	`3840x2160`
21:9	Кинематографический	`3840x1632`

Единая тарификация для всех 30 размеров: $0.03 за изображение. Для детализации 4K дополнительная плата не взимается.

Выбор уровня:

1K Быстрый — черновики, миниатюры, A/B-тесты. Самый быстрый результат (цена фиксированная, но цикл итераций короче).
2K Рекомендуемый — уровень по умолчанию. Подходит для большинства результатов для продакшена (главные изображения товаров для электронной коммерции, постеры, инфографика).
4K Детализация — печать, большие дисплеи, миниатюры видео, большие форматы для настольных экранов и наружной рекламы.

Минимальный пример вызова (передавайте только size, не передавайте quality):

curl "https://api.apiyi.com/v1/images/generations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $YI_API_KEY" \
  -d '{
    "model": "gpt-image-2.5-vip",
    "prompt": "Product shot of a white ceramic mug on a gray desk, soft natural light, clean background",
    "size": "2048x1360"
  }'

Лучшие практики

Сжимайте входные изображения до размера менее 1,5 МБ (редактирование изображений / объединение нескольких изображений)

Сжимайте каждое загружаемое изображение до размера менее 1,5 МБ (качество JPEG 80–90 / уменьшенное разрешение); при объединении нескольких изображений применяйте такой же лимит к каждому изображению. Периодические ответы shell_api_error / Unknown error чаще всего вызываются слишком большими входными данными — сжатие заметно повышает процент успешных запросов и снижает задержку. Разрешение результата определяется полем size, а не размером входных данных — уменьшение входного изображения лишь ускоряет обработку и не ухудшает качество. Добавление 4K / 8K в промпт не создаёт изображение 4K; разрешение задаётся параметром size, а не лишним текстом в промпте.

Выбирайте уровень размера в зависимости от результата

1K — быстро для черновиков, 2K — рекомендуется для рабочих материалов, 4K — высокая детализация для печати и больших экранов. Цена фиксированная — выбирайте вариант в зависимости от задачи.

Используйте строчную ASCII-букву x в размере

Отправляйте "size": "1536x1024" — не 1536×1024 и не заглавную X.

параметр quality поддерживает значение high; не передавайте n

Все три модели -vip принимают auto / low / medium / high в ходе тестирования (это не является гарантией; только 2.5 high соответствует gpt-image-2-vip medium), а xhigh / max отклоняются. n в любом случае возвращает 1 изображение за вызов — для получения нескольких изображений выполняйте вызовы параллельно.

Используйте тайм-аут 300 с

Обычная генерация занимает 90–150 с, однако время загрузки и скачивания изображения, а также задержки в периоды пиковой нагрузки могут увеличить этот срок. В качестве консервативного базового значения установите 300 с.

Выбирайте формат ответа в зависимости от задачи

Используйте b64_json для непосредственного отображения в веб-интерфейсе; url — для хранения или пересылки на стороне сервера.

Используйте общий код для -all

Один и тот же код работает для обоих вариантов — при необходимости переключайте model между gpt-image-2-all и gpt-image-2-vip. Используйте vip, когда требуется фиксированный размер, и возвращайтесь к -all для максимально быстрой итерации.

Коды ошибок и повторные попытки

Статус	Значение	Рекомендация
`400`	размер отсутствует в наборе из 30 размеров или имеет некорректный формат	Используйте точные строки из таблицы выше
`401`	Недействительный token	Проверьте Bearer-токен
`429`	Отклонённый параметр / периодическая перегрузка upstream-сервиса / квота исчерпана	В пределах 500 RPM планирование параллельных запросов не требуется. Если вы получили `429`, сначала прочитайте `error.message`: для отклонённого параметра (`quality must be one of…`) достаточно исправить параметр; `当前分组上游负载已饱和` (upstream-сервис перегружен) возникает периодически — повторите запрос с увеличивающейся задержкой, уточните в службе поддержки статус модели или проверьте Актуальные обновления
`500` (периодически для 4K)	Колебания вычислительных ресурсов upstream-сервиса OpenAI; для уровня детализации 4K эта ошибка возникает чаще	Переключитесь на рекомендуемый режим 2K и повторите запрос; если 4K обязателен, переключитесь на официальный прокси `gpt-image-2` + группу `image2Enterprise`
`5xx` (прочее)	Временная ошибка шлюза/бэкенда	Повторите запрос 1–2 раза
Тайм-аут	Пиковая нагрузка upstream-сервиса + длительный хвост для 4K	Установите тайм-аут клиента ≥ 300 с (с запасом)

Рекомендации для клиента:

Тайм-аут запроса начиная с 300 секунд (с запасом; обычно 90–150 с, но для 4K Detail и хвостов пиковых нагрузок требуется больше)
Используйте экспоненциальную задержку для ошибок 5xx и тайм-аутов (рекомендуется 2–3 повторные попытки)
Для отладки регистрируйте заголовок ответа request-id

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

Можно ли использовать один и тот же код для vip и -all?

Да, они почти идентичны. Оба эндпоинта (/v1/images/generations, /v1/images/edits) используют одинаковые поля запроса, поля ответа и поведение префикса b64_json. Единственные различия:

Поле model: gpt-image-2-vip ↔ gpt-image-2-all
Поле size: vip принимает набор из 30 размеров; -all отклоняет size (размер указывается в промпте)

Практический подход: поддерживайте одну кодовую базу с переключателем if model == 'vip': payload['size'] = ....

Почему vip работает намного медленнее?

gpt-image-2-vip использует обратный канал Adobe (Firefly) — обычно 90–150 секунд, что сопоставимо с официальным gpt-image-2 (100–120 с), но медленнее, чем ChatGPT-web-line gpt-image-2-all (30–60 с). Для задач, чувствительных к задержке, предпочтительнее gpt-image-2-all; переключайтесь на vip только когда вам нужен фиксированный размер или 4K.

Размер обязательно должен быть указан в таблице? Что произойдёт, если я отправлю 1024x768?

Используйте набор из 30 размеров. По результатам тестирования на 2026-09-09 размеры, отсутствующие в списке, больше не вызывают ошибку; перед генерацией они преобразуются: значения, кратные 16, передаются как есть (1024x1024 / 1600x1600), остальные выравниваются по 16 (1920x1080 → 1920×1088), а слишком маленькие значения увеличиваются до минимальной длины стороны (512x512 → 816×816). Полученное изображение может не соответствовать запросу, поэтому при необходимости точного размера всегда используйте один из 30 предустановленных вариантов.

Почему при использовании 4K часто возвращается ошибка 500? Как получить стабильный 4K?

Симптом: на уровне детализации 4K (например, 3840x2160 / 2880x2880) ошибки status_code: 500 возникают чаще, а вышестоящий сервис возвращает invalid_request_error:

{
  "status_code": 500,
  "error": {
    "message": "An error occurred while processing your request. ... Please include the request ID xxxxxxxx in your message.",
    "type": "invalid_request_error",
    "code": null
  }
}

Основная причина: колебания вычислительных ресурсов OpenAI, а не параметры вашего запроса. Одна и та же нагрузка обычно успешно обрабатывается в режиме 2K. Обратный канал более чувствителен к большим результатам, например 4K, особенно в часы пиковой нагрузки.Способы устранения (в порядке экономической эффективности):

Предпочитайте 2K Recommended (например, 2048x1360 / 2048x2048) — значительно более высокая вероятность успеха при той же стоимости $0.03/изображение
Отправляйте меньше входных изображений для img2img / объединения нескольких изображений — обратный канал испытывает трудности при большой входной нагрузке, что дополнительно повышает вероятность ошибок 4K; предварительное сжатие каждого входного изображения до размера менее 1.5MB также помогает
Для гарантированного 4K — переключитесь на официальный прокси gpt-image-2 + группу image2Enterprise. 4K через официальный прокси стоит дороже (~$0.3+/изображение), но работает значительно стабильнее — это подходящий вариант, когда передача в 4K является обязательным требованием.

📖 Практическая заметка: /en/live/2026-05/gpt-image-2-vip-4k-tips

Нужно ли сжимать входные изображения? Поможет ли указание 4K / 8K в промпте?

Да, это настоятельно рекомендуется. Сжимайте каждое входное изображение до размера менее 1.5MB (качество JPEG 80–90 / уменьшенное разрешение): периодические ответы shell_api_error / Unknown error чаще всего вызываются слишком большими входными данными, а сжатие заметно повышает вероятность успеха и уменьшает задержку. Обратите внимание: 1.5MB — это рекомендуемый верхний предел для надёжности и скорости; значение 10MB, указанное выше в разделе часто задаваемых вопросов, является жёстким ограничением шлюза.Не беспокойтесь, что сжатие ухудшит качество — разрешение результата определяется параметром size, а не размером входных данных. Уменьшение входного изображения только ускоряет обработку.Указание 4K / 8K в промпте фактически не создаёт изображение в 4K. Если в промпте указано 8K ultra HD, но для size задано значение 1024x1024, вы всё равно получите изображение качества 1K. Для 4K укажите значение в поле size — 1K / 2K / 4K стоят одинаково — фиксированные $0.03/изображение для всех 30 размеров.📖 Источник: /en/live/2026-05/gpt-image-2-vip-unknown-error

Действительно ли за 4K не взимается дополнительная плата?

Дополнительная плата не взимается. Уровень детализации 4K (3840x2160 / 2880x2880 и т. д.) стоит столько же — $0.03/изображение, — сколько 1K и 2K.

Поддерживается ли параметр n? Что произойдёт, если передать n=3?

Нет. Эта модель возвращает 1 изображение за вызов — для получения нескольких изображений используйте повторные / параллельные запросы.⚠️ Важно: если передать n=3 в запросе, тарификация составит 0.03 × 3 = $0.09, но фактически будет возвращено только 1 изображение. Удалите поле n, чтобы избежать лишних расходов.

Если содержимое отклонено или модель отвечает «Я не могу это сделать», взимается ли плата?

Это обратно разработанный канал, использующий синхронные ответы в стиле чата. Результаты делятся на два случая с разными правилами тарификации:1) Возвращён HTTP 5xx → плата НЕ взимаетсяКогда политика содержимого вышестоящего сервиса блокирует запрос, вы увидите что-то вроде:

{
  "error": {
    "message": "Image was not generated as expected. Please adjust the prompt and retry (traceid: 0672821c6951af183dbf847130caaf16)",
    "localized_message": "Unknown error",
    "type": "invalid_request_error",
    "param": "",
    "code": null
  }
}

За такие жёсткие ошибки плата не взимается. Попросите пользователя изменить промпт и повторить запрос.2) HTTP 200 с текстовым «мягким отказом» → плата ВЗИМАЕТСЯКогда модель мягко отказывает в рамках диалога (например, «Я не могу это сделать», «Извините, этот запрос касается…»), на уровне протокола это выглядит как обычное завершение чата, поэтому плата взимается. На уровне протокола обратный канал не может надёжно отличить «текст отказа» от «результата в виде изображения».Почему мы не можем просто отменить плату за мягкие отказыАвтоматическая отмена платы за каждый мягкий отказ означала бы, что платформа оплачивает каждый неудачный вызов вышестоящего сервиса. Что ещё важнее, частое срабатывание системы безопасности контента вышестоящего сервиса также повышает риск блокировки аккаунта поставщика — это реальные затраты на стороне поставок, которые мы не можем полностью устранить.Рекомендации для интеграторов

✅ Предварительно фильтруйте запросы и предупреждайте пользователей: добавьте фильтр ключевых слов и сценариев на стороне интерфейса или шлюза (имена реальных людей, персонажи, защищённые авторским правом, чувствительные темы) и показывайте в интерфейсе подсказку вроде «Запросы о знаменитостях или объектах интеллектуальной собственности могут завершиться ошибкой и всё равно тарифицироваться по политике вышестоящего сервиса». Это значительно сокращает лишние расходы.
✅ Ежемесячное возмещение для потребительских продуктов: мы понимаем, что продукты для конечных пользователей не могут полностью ограничивать ввод. Если ваши ежемесячные расходы достаточно велики ($1000+/месяц), вы можете раз в месяц собирать журналы запросов (вызовы с малой задержкой обычно завершаются мягкими отказами) и обратиться в поддержку за разовым ручным начислением кредита — нет необходимости подавать отдельные обращения по каждому вызову.

📖 См. также: Ошибки 500 обычно вызваны срабатыванием политики контента (плата не взимается)

Нужно ли добавлять префикс data:image/png;base64, к b64_json?

Сначала определите наличие префикса, затем обработайте значение. Согласно проверке, проведённой в июле 2026 года, возвращаемый b64_json — это необработанный base64 без префикса data:: декодируйте его для записи в файл или самостоятельно добавьте префикс перед отображением; в более ранних версиях префикс присутствовал. Добавьте в код проверку startsWith('data:'): если префикс присутствует, используйте значение напрямую как img src; если нет — сначала декодируйте или добавьте префикс. Это предотвращает повторное добавление префикса и декодирование строки с префиксом в повреждённое изображение.

Каков максимальный размер эталонного изображения и какие форматы поддерживаются?

Рекомендуемый размер — ≤ 10MB на изображение, форматы png / jpg / webp. Слишком большие изображения могут столкнуться с ограничениями шлюза. Каждое изображение при объединении нескольких изображений должно соответствовать этому ограничению.

Как долго действуют возвращаемые URL изображений? Нужно ли скачивать изображения?

Поле url в ответе в режиме url — это ссылка CDN R2, срок действия которой составляет около 1 дня (24 часов); запросы после этого срока будут возвращать ошибку 404.Настоятельно рекомендуется вскоре после генерации скачивать созданные изображения и сохранять их в собственном объектном хранилище (S3 / OSS / R2), CDN или базе данных.

Поддерживается ли потоковая передача?

Нет. Эта модель возвращает изображение целиком одним ответом; потоковая передача не поддерживается. Если задержка важна, показывайте на стороне клиента индикатор выполнения с текстом «идёт генерация…» и установите тайм-аут 300 с (с запасом).

Можно ли использовать официальный SDK OpenAI?

Да. Направьте base_url на https://api.apiyi.com/v1 и задайте api_key, указав ваш токен APIYI. client.images.generate(model="gpt-image-2.5-vip", size="2048x1360", prompt=...) работает напрямую.

Можно ли по-прежнему генерировать изображения через /v1/chat/completions?

Да, эндпоинт по-прежнему работает, но больше не рекомендуется — вместо него используйте /v1/images/generations и /v1/images/edits (они стабильнее, а тот же код работает с gpt-image-2 официального релея).Стиль на основе чата имеет смысл только в двух сценариях: многошаговое итеративное редактирование или прямая передача URL изображений из интернета. Обратите внимание: если намерение создать изображение неоднозначно, модель может вернуть обычный текст вместо изображения. Чтобы усилить это намерение, добавьте к промпту фиксированный префикс, например «Создайте изображение:».Полный список параметров см. в справочнике API на основе чата.

Когда следует переключаться на официальный gpt-image-2?

Если вам нужны уровни качества xhigh / max, точное закрашивание маской или строгое соответствие полям OpenAI-API — используйте официальный gpt-image-2.5-flare / sunburst / gpt-image-2. См. сравнение официального и обратного каналов.

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

Обзор GPT-Image-2-All — родственная модель по той же цене с более быстрым выводом, идеальна, когда не требуется фиксировать размер
⚖️ Сравнение официального и обратного вариантов — руководство по выбору бок о бок по сравнению с официальным gpt-image-2 (охватывает -all / -vip)
Песочница преобразования текста в изображение — эндпоинт, совместимый с /v1/images/generations; передайте size, чтобы зафиксировать размеры
Песочница редактирования изображений — объединение и редактирование нескольких изображений с помощью /v1/images/edits
GPT-Image-2.5 / 2: официальная версия — для уровней xhigh / max, точного дорисовывания по маске и строгого соответствия полей OpenAI-API
Подробный разбор: запуск GPT-image-2.5 — запуск двойной модели версии 2.5
Обзор серии GPT-Image — сравнение официальных моделей GPT-Image
Руководство по API — общие соглашения для вызова

gpt-image-2-vip — это канал с обратной разработкой (линейка Adobe, Firefly). Поведение согласовано, однако цены и возможности могут не полностью соответствовать официальной версии. Для полного соответствия официальному API используйте gpt-image-2.

Основы

Базовый API

Image API (официальный)

Video API (официальный)

API мультимодального понимания

Генерация текста

Audio API (официальный)

Поиск и безопасность

GPT-Image-2.5-VIP: генерация/редактирование изображений

Обзор

API преобразования текста в изображение

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

Позвольте AI-агенту выполнить интеграцию

Основные различия по сравнению с `gpt-image-2-all`

Сравнение трёх моделей -vip (измерения от 2026-09-09)

Основные возможности

Фиксированный размер вывода

4K с высоким разрешением

Единая стоимость для всех размеров

Тот же формат вызова, что и -all

Высококачественный рендеринг текста

Поддержка китайских prompt

Редактирование на естественном языке

Поддержка стандартных эндпоинтов

Тарификация

Настройка группы

Нужен детерминированный вывод URL → переключитесь на группу `image2_OSS`

Технические характеристики

Эндпоинты

Поддерживаемые размеры (полная таблица из 30 размеров)

1K Быстрый — черновики и недорогие итерации

2K Рекомендуемый — уровень по умолчанию (большинство результатов для продакшена)

4K Детализация — материалы большого формата

Лучшие практики

Коды ошибок и повторные попытки

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

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

​Обзор

API преобразования текста в изображение

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

​Позвольте AI-агенту выполнить интеграцию

​Основные различия по сравнению с gpt-image-2-all

​Сравнение трёх моделей -vip (измерения от 2026-09-09)

​Основные возможности

Фиксированный размер вывода

4K с высоким разрешением

Единая стоимость для всех размеров

Тот же формат вызова, что и -all

Высококачественный рендеринг текста

Поддержка китайских prompt

Редактирование на естественном языке

Поддержка стандартных эндпоинтов

​Тарификация

​Настройка группы

​Нужен детерминированный вывод URL → переключитесь на группу image2_OSS

​Технические характеристики

​Эндпоинты

​Поддерживаемые размеры (полная таблица из 30 размеров)

​1K Быстрый — черновики и недорогие итерации

​2K Рекомендуемый — уровень по умолчанию (большинство результатов для продакшена)

​4K Детализация — материалы большого формата

​Лучшие практики

​Коды ошибок и повторные попытки

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

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

Обзор

Позвольте AI-агенту выполнить интеграцию

Основные различия по сравнению с `gpt-image-2-all`

Сравнение трёх моделей -vip (измерения от 2026-09-09)

Основные возможности

Тарификация

Настройка группы

Нужен детерминированный вывод URL → переключитесь на группу `image2_OSS`

Технические характеристики

Эндпоинты

Поддерживаемые размеры (полная таблица из 30 размеров)

1K Быстрый — черновики и недорогие итерации

2K Рекомендуемый — уровень по умолчанию (большинство результатов для продакшена)

4K Детализация — материалы большого формата

Лучшие практики

Коды ошибок и повторные попытки

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

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