Перейти к основному содержанию
Параметр 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 — это реверс-инжиниринговые модели генерации изображений GPT на линии Adobe (Firefly) от APIYI — высококачественная реверс-линия GPT-Image 2.5, а не низкокачественный апскейлинг. Фиксированная цена составляет $0.03/изображение, при этом формат запроса и ответа идентичен gpt-image-2.5-all ($0.025/изображение) — единственное существенное отличие заключается в том, что vip принимает поле size с 30 популярными размерами (10 соотношений сторон × 3 уровня разрешения: 1K Быстрый / 2K Рекомендуемый / 4K Детализированный), включая 4K.
🎨 Позиционирование: используйте gpt-image-2.5-vip, когда вам нужно зафиксировать выходной размер (главные баннеры для e-commerce, шаблоны постеров, превью для видео, обои 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 — текстовый prompt + size для точного указания выходных размеров.

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

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

Доверьте интеграцию ИИ-агенту

Скопируйте этот prompt и вставьте его в Codex / Claude Code / Cursor

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

Выполните интеграцию / диагностику генерации (text-to-image) и редактирования изображений с помощью gpt-image-2.5-vip в этом проекте (gpt-image-2.5-flare-vip / gpt-image-2-vip имеют одинаковую стоимость и формат вызова; сделайте …

Прочтите документацию перед тем, как писать код: получите https://docs.apiyi.com/en/api-capabilities/gpt-image-2-vip/overview.md для текстовой версии этой страницы. Для более подробной информации о параметрах добавьте .md к …

  1. Таймаут: увеличьте таймаут клиента до 360 секунд. API генерации изображений синхронные — task ID отсутствует, поэтому при отключении клиента результат будет потерян …

Всего 7 требований. Используйте кнопку ниже, чтобы скопировать полный prompt.

Ключевые отличия от gpt-image-2-all

gpt-image-2-vip и gpt-image-2-all — оба представляют собой реверс-инжиниринговые каналы с одинаковым кодом вызова (-all $0.025/изображение, -vip $0.03/изображение). Они зеркально повторяют друг друга — замените поле model в том же запросе, и поведение будет практически идентичным. Отличия:
Краткий вывод: не требуется строгий размер, нужен максимально быстрый результат → gpt-image-2-all; требуется фиксированный размер или 4K → gpt-image-2-vip; нужна настройка quality или строгое соответствие полям API OpenAI → используйте официальный gpt-image-2.

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

Сравнение по трём вариантам на 253 запросах с одинаковыми каналом и token, где менялось только имя модели, а также 26 последовательных пограничных вызовов. Контракт идентичен ячейка в ячейку; различаются только строки ниже. quality и прозрачный фон ранее отклонялись gpt-image-2-vip, но теперь принимаются — это поведение канала, а не обязательство; ориентируйтесь на фактический ответ.
Как выбрать: для повседневной генерации изображений по тексту по умолчанию используйте gpt-image-2.5-vip; для скорости выберите gpt-image-2.5-flare-vip; для высшего уровня tokens отправляйте max на 2.5 или high на gpt-image-2-vip (одинаковое количество tokens). Ни одна из трёх моделей не выполняет точный inpainting по маске; для этого используйте официальный GPT-Image-2.5 / 2. Размер по умолчанию ранее уже менялся на стороне поставщика, поэтому всегда явно передавайте 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

Цены

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

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

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

Нужен детерминированный вывод 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

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

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

Эндпоинты

gpt-image-2-vip совместим с теми же самыми двумя эндпоинтами, что и gpt-image-2-all. Просто замените поле model и при необходимости добавьте size:
Используйте OpenAI Images API (/v1/images/generations + /v1/images/edits) по двум причинам:
  1. Более высокая стабильность: объём доступных апстрим-ресурсов для канала Images API больше, поэтому процент успешных вызовов выше
  2. Совместимость с официальным релеем для простого переключения: способ вызова и такие параметры, как size, полностью совместимы с официальным релеем gpt-image-2 — если на реверс-канале возникнут проблемы с риск-контролем, достаточно просто изменить название model без каких-либо правок в коде
Также доступен эндпоинт на основе чата (/v1/chat/completions, больше не рекомендуется) — см. раздел FAQ ниже.
Варианты доменов: api.apiyi.com — основной домен. Вы также можете использовать альтернативные домены шлюза, такие как b.apiyi.com. Поведение ответов полностью идентично.

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

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

1K Fast — черновики и низкозатратные итерации

4K Detail — материалы крупного формата

Единая цена для всех 30 размеров: $0.03/изображение. Без наценки за 4K Detail.
Выбор уровня:
  • 1K Fast — черновики, миниатюры, A/B-тесты. Самая быстрая генерация (цена единая, но цикл итераций короче).
  • 2K Recommended — уровень по умолчанию. Подходит для большинства рабочих материалов (главные баннеры e-commerce, плакаты, инфографика).
  • 4K Detail — печать, большие экраны, обложки видео, широкоформатные материалы для десктопа и наружной рекламы.
Минимальный пример вызова (только size; quality необязателен, см. выше):

Рекомендации

1

Сжимайте входные изображения до размера менее 1.5MB (редактирование изображений / объединение нескольких изображений)

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

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

1K Fast — для черновиков, 2K Recommended — для продакшена, 4K Detail — для печати и больших дисплеев. Цена фиксированная — выбирайте по необходимости.
3

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

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

quality поддерживается до high; не передавайте n

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

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

Типичная генерация занимает 90–150s, но время загрузки / скачивания изображений и задержка на пиковых значениях увеличивают этот срок. Установите 300s в качестве консервативного базового значения.
6

Выбирайте формат ответа по необходимости

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

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

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

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

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

FAQ

Да, они почти идентичны. Оба эндпоинта (/v1/images/generations, /v1/images/edits) используют одинаковые поля запроса, поля ответа и поведение префикса b64_json. Отличия только следующие:
  1. Поле model: gpt-image-2-vip ↔ gpt-image-2-all
  2. Поле size: vip принимает набор из 30 размеров; -all отклоняет size (размер указывается в промпте)
Практический подход: поддерживайте одну кодовую базу с переключателем if model == 'vip': payload['size'] = ....
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.
Придерживайтесь набора из 30 размеров. По состоянию на тестирование 2026-09-09 размеры, отсутствующие в списке, больше не вызывают ошибку; перед генерацией они преобразуются: числа, кратные 16, передаются без изменений (1024x1024 / 1600x1600), остальные выравниваются по 16 (1920x1080 → 1920×1088), а значения меньше допустимого увеличиваются до минимального размера стороны (512x512 → 816×816). Полученное изображение может не соответствовать запросу, поэтому всегда используйте 30 предустановленных размеров, когда важен точный размер.
Симптом: на уровне 4K Detail (например, 3840x2160 / 2880x2880) ошибки status_code: 500 возникают чаще, а upstream возвращает invalid_request_error:
Первопричина: колебания вычислительных ресурсов OpenAI, а не параметры вашего запроса. Те же данные обычно успешно обрабатываются в режиме 2K. Обратный канал более чувствителен к большим результатам, таким как 4K, особенно в часы пик.Способы устранения (по соотношению эффективности и стоимости):
  1. Предпочитайте 2K Recommended (например, 2048x1360 / 2048x2048) — значительно более высокий процент успешных запросов при той же стоимости $0.03/изображение
  2. Отправляйте меньше входных изображений для img2img / объединения нескольких изображений — обратный канал испытывает сложности при большой входной нагрузке, что дополнительно повышает частоту ошибок 4K; предварительное сжатие каждого входного изображения до размера менее 1.5MB также помогает
  3. Для гарантированного 4K — переключитесь на официальный прокси gpt-image-2 + группу image2Enterprise. 4K через официальный прокси стоит дороже (~$0.3+/изображение), но работает значительно стабильнее — это подходящий вариант, когда выдача в 4K является обязательным требованием.
📖 Практическая заметка: /en/live/2026-05/gpt-image-2-vip-4k-tips
Да, это настоятельно рекомендуется. Сжимайте каждое входное изображение до размера менее 1.5MB (качество JPEG 80–90 / уменьшенное разрешение): периодические ответы shell_api_error / Unknown error чаще всего вызываются слишком большими входными данными, а сжатие заметно повышает процент успешных запросов и уменьшает задержку. Примечание: 1.5MB — это рекомендуемый предел для надёжности и скорости; значение 10MB, указанное выше в FAQ, является жёстким лимитом шлюза.Не беспокойтесь, что сжатие ухудшит качество — разрешение результата определяется параметром 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 Detail (3840x2160 / 2880x2880 и т. д.) стоит столько же — $0.03 за изображение, как 1K и 2K.
Нет. Эта модель возвращает 1 изображение за вызов — для получения нескольких изображений используйте повторные / параллельные вызовы.⚠️ Важно: если передать n=3 в запросе, тарификация составит 0.03 × 3 = $0.09, но фактически будет возвращено только 1 изображение. Уберите поле n, чтобы избежать лишних расходов.
Это обратно разработанный канал, использующий синхронные ответы в стиле чата. Результаты делятся на два случая с разными правилами тарификации:1) Возвращён HTTP 5xx → НЕ тарифицируетсяЕсли политика содержимого upstream полностью блокирует запрос, вы увидите примерно следующее:
Такие жёсткие ошибки не тарифицируются. Попросите пользователя изменить промпт и повторить запрос.2) HTTP 200 с текстовым «мягким отказом» → ТАРИФИЦИРУЕТСЯЕсли модель мягко отказывает внутри диалога (например, «Я не могу это сделать», «Извините, этот запрос связан с…»), на уровне протокола это выглядит как обычное завершение чата, поэтому запрос тарифицируется. Обратный канал не может надёжно отличить «текст отказа» от «изображения» на уровне протокола.Почему мы не можем просто отменить тарификацию мягких отказовАвтоматическая отмена тарификации для каждого мягкого отказа означала бы, что платформа оплачивает каждый неудачный вызов upstream. Что ещё важнее, частое срабатывание системы безопасности содержимого upstream также повышает риск блокировки аккаунта поставщика — это реальные издержки на стороне поставок, которые мы не можем полностью устранить.Рекомендации для разработчиков интеграций
  • ✅ Предварительно фильтруйте запросы и предупреждайте пользователей: добавьте фильтр ключевых слов и сценариев на frontend или шлюзе (имена реальных людей, персонажи, защищённые авторским правом, чувствительные темы) и показывайте в интерфейсе подсказку вроде «Запросы о знаменитостях и объектах интеллектуальной собственности могут завершиться ошибкой и всё равно тарифицироваться по политике upstream». Это значительно сокращает лишние расходы.
  • ✅ Ежемесячное возмещение для потребительских продуктов: мы понимаем, что продукты для конечных пользователей не могут полностью ограничивать ввод. Если ваши ежемесячные расходы достаточно велики ($1000+/месяц), вы можете ежемесячно объединять логи (вызовы с небольшой задержкой обычно являются мягкими отказами) и обратиться в поддержку за разовым ручным начислением кредита — не нужно подавать отдельные обращения по каждому вызову.
📖 Связанный материал: Ошибки 500 обычно вызваны срабатыванием политики содержимого (не тарифицируются)
Сначала определите наличие префикса, затем обработайте значение. Как подтверждено в июле 2026 года, возвращаемый b64_json содержит необработанный base64 без префикса data: — декодируйте его для записи в файл или самостоятельно добавьте префикс перед отображением; в более ранних версиях префикс присутствовал. Добавьте в код проверку startsWith('data:'): если префикс присутствует, используйте значение напрямую как img src; если нет — сначала декодируйте его или добавьте префикс. Это предотвращает повторное добавление префикса и декодирование строки с префиксом в повреждённое изображение.
Рекомендуемый размер — ≤ 10MB на изображение, форматы png / jpg / webp. Слишком большие изображения могут достигать лимитов шлюза. Каждое изображение при объединении нескольких изображений должно соответствовать этому ограничению.
Поле url в ответе в режиме url — это ссылка на CDN R2, срок действия которой истекает примерно через 1 день (24 часа); запросы после этого будут возвращать ошибку 404.Настоятельно рекомендуется вскоре после генерации скачивать созданные изображения и сохранять их в собственном объектном хранилище (S3 / OSS / R2), CDN или базе данных.
Нет. Эта модель возвращает изображение целиком одним ответом; потоковая передача не поддерживается. Если задержка важна, показывайте на стороне клиента индикатор выполнения «идёт генерация…» и настройте тайм-аут 300 с (с запасом).
Да. Направьте base_url на https://api.apiyi.com/v1 и задайте для api_key ваш APIYI token. client.images.generate(model="gpt-image-2.5-vip", size="2048x1360", prompt=...) работает напрямую.
Да, эндпоинт по-прежнему работает, но его больше не рекомендуется использовать — вместо него используйте /v1/images/generations и /v1/images/edits (они стабильнее, а тот же код работает с gpt-image-2 официального релея).Стиль на основе чата имеет смысл только в двух сценариях: итеративное редактирование в несколько ходов или непосредственная передача URL изображений из интернета. Обратите внимание: если намерение создать изображение неоднозначно, модель может вернуть обычный текст вместо изображения (добавьте в начало промпта фиксированный префикс вроде «Сгенерируй изображение:», чтобы явно указать это намерение).Полный список параметров см. в справочнике API на основе чата.
Если вам нужны точное дорисовывание по маске или строгое соответствие полям OpenAI-API (включая официально заявленные уровни quality), используйте официальный gpt-image-2.5-flare / sunburst / gpt-image-2. См. Сравнение официального и обратного каналов.

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

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