Skip to main content
Параметр 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-vip — это реверс-инжиниринговая модель генерации изображений GPT в линейке Codex, доступная на платформе APIYI. Та же фиксированная стоимость $0.03/image , что и у gpt-image-2-all, и идентичный формат запроса/ответа — единственное существенное отличие в том, что vip принимает поле size с 30 распространенными размерами (10 соотношений сторон × 3 уровня разрешения: 1K Fast / 2K Recommended / 4K Detail), включая 4K.
🎨 Позиционирование: используйте gpt-image-2-vip, когда вам нужно зафиксировать размер вывода (hero-изображения для e-commerce, шаблоны постеров, миниатюры видео, обои 4K и т. д.). Просто замените поле model на gpt-image-2-vip и добавьте поле size — весь остальной код остается таким же, как у gpt-image-2-all.

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

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

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

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

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

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

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

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

Поле 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/image для всех 30 размеров — без доплаты за 4K Detail
  • Неудачные запросы не тарифицируются (ошибки аутентификации, ошибки проверки параметров)
  • Для N изображений вызывайте API N раз параллельно

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

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

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

По измерениям в июле 2026 года в группе по умолчанию, gpt-image-2-vipgpt-image-2-all) возвращают b64_json, когда response_format не указан; передайте response_format: "url" явно, чтобы получить URL изображения. Формат вывода группы по умолчанию не гарантирован — исторически по умолчанию использовался url с переходом на b64_json при нагрузке, и это менялось между версиями канала. Если ваш бизнес зависит от вывода URL (запись URL напрямую в базу данных, отображение на frontend по URL, base64 неприемлем), переключите группу вашего token на image2_OSS — группу, специально созданную для детерминированного вывода URL, с коэффициентом тарифа 1x (без надбавки), действующую для обеих реверс-моделей gpt-image-2-vip и gpt-image-2-all. Она гарантирует, что ответ всегда содержит URL изображения и никогда не переходит на base64.
Экран создания token: сначала режим тарификации 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): если ваш token покрывает все три модели, задайте приоритет групп вашего token так:
  • Первый приоритет: image2Enterprise (корпоративная группа с коэффициентом тарифа 1.2x, выделенная стабильная полоса для официального релея)
  • Резерв по умолчанию: Default (обе реверс-модели находятся здесь и маршрутизируются по модели)
Итог: официальный релей gpt-image-2 использует корпоративную полосу для стабильности, а две реверс-модели остаются в группе по умолчанию — один token покрывает все три, без взаимного влияния.
📖 О группе 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. Более стабильно: upstream-ресурсов для канала Images API больше, поэтому процент успешных вызовов выше
  2. Совместимость с официальным релеем для простого переключения: метод вызова и параметры вроде 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 Быстрый — черновики и недорогие итерации

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

4K Детальный — крупноформатные материалы

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

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

1

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

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

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

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

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

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

Не передавайте quality или n

quality отклоняется; n возвращает 1 изображение за вызов независимо — для нескольких изображений вызывайте параллельно.
5

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

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

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

Используйте b64_json для прямого рендеринга в web; url для хранения/передачи на стороне сервера.
7

Делитесь кодом с -all

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

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

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

FAQ

Да, почти идентично. Оба эндпоинта (/v1/images/generations, /v1/images/edits) используют одинаковые поля запроса, поля ответа и поведение префикса b64_json. Единственные различия:
  1. поле model: gpt-image-2-vipgpt-image-2-all
  2. поле size: vip принимает набор из 30 размеров; -all отклоняет size (размер вместо этого указывается в prompt)
Практический вариант: оставьте одну кодовую базу с переключателем if model == 'vip': payload['size'] = ....
gpt-image-2-vip использует обратный канал Codex — типично 90–150 секунд, сопоставимо с официальным gpt-image-2 (100–120с) и медленнее, чем ChatGPT-web-line gpt-image-2-all (30–60с). Для задач, чувствительных к задержке, лучше использовать gpt-image-2-all; переключайтесь на vip только когда вам нужны фиксированный размер или 4K.
Да — придерживайтесь набора из 30 размеров. Размеры не из списка могут вызвать upstream invalid_request_error. Выберите ближайший уровень для вашего результата.
Симптом: на уровне 4K Detail (например, 3840x2160 / 2880x2880), ошибки status_code: 500 проще спровоцировать, при этом upstream возвращает invalid_request_error:
Причина: колебания вычислительных ресурсов OpenAI — не ваши параметры запроса. Тот же payload обычно проходит на 2K. Обратный канал Codex более чувствителен к крупным выходам вроде 4K, особенно в часы пик.Способы снизить риск (по соотношению цена/эффект):
  1. Отдавайте предпочтение 2K Recommended (например, 2048x1360 / 2048x2048) — заметно более высокий процент успеха, та же $0.03/image
  2. Передавайте меньше входных изображений для img2img / слияния нескольких изображений — обратный канал Codex хуже работает при большой входной нагрузке, что еще сильнее повышает частоту сбоев 4K; предварительное сжатие каждого входного изображения ниже 1.5MB тоже помогает
  3. Для гарантированного 4K — переключитесь на официальный-прокси gpt-image-2 + image2Enterprise группа. 4K через официальный-прокси дороже (~$0.3+/image), но заметно стабильнее — подходит, когда поставка 4K является жестким требованием.
📖 Примечание из практики: /en/live/2026-05/gpt-image-2-vip-4k-tips
Да, настоятельно рекомендуется. Сжимайте каждое входное изображение ниже 1.5MB (JPEG quality 80-90 / уменьшенное разрешение): разовые ответы shell_api_error / Unknown error чаще всего вызываются слишком большими входными данными, а сжатие заметно повышает процент успеха и снижает задержку. Примечание: 1.5MB — рекомендуемый верхний предел для надежности и скорости; число 10MB в FAQ выше — это жесткий лимит шлюза.Не беспокойтесь, что сжатие ухудшит качество — выходное разрешение определяется параметром size, а не размером входа. Уменьшение входа только ускоряет работу.Добавление 4K / 8K в prompt на самом деле не дает выход 4K. Если в prompt вы пишете 8K ultra HD, но для size задаете 1024x1024, вы все равно получите изображение качества 1K. Для 4K задавайте это в поле size — 1K / 2K / 4K стоят одинаково: фиксированные $0.03/image во всем наборе из 30 размеров.📖 Источник: /en/live/2026-05/gpt-image-2-vip-unknown-error
Нет дополнительной платы. Уровень 4K Detail (3840x2160 / 2880x2880 и т. д.) стоит те же $0.03/image, что и 1K и 2K.
Нет. Эта модель возвращает 1 изображение за один вызов — для нескольких изображений используйте повторные / параллельные вызовы вместо этого.⚠️ Важно: если вы передадите n=3 в запросе, billing составит 0.03 × 3 = $0.09, но фактически будет возвращено только 1 изображение. Уберите поле n, чтобы избежать лишних списаний.
Это реверс-инжиниринговый канал, использующий синхронные ответы в стиле chat. Результаты делятся на два случая с разными правилами тарификации:1) Возвращен HTTP 5xx → НЕ тарифицируетсяКогда upstream content policy жестко блокирует запрос, вы увидите что-то вроде:
Такие жесткие ошибки не тарифицируются. Попросите пользователя изменить prompt и повторить попытку.2) HTTP 200 с текстовым “мягким отказом” → ТАРИФИЦИРУЕТСЯКогда модель мягко отказывает внутри диалога (например, “I can’t do that”, “Sorry, this request involves…”), на уровне протокола это выглядит как обычное chat completion, поэтому это тарифицируется. Обратный канал не может надежно отличить “текст отказа” от “вывода изображения” на уровне протокола.Почему мы не можем просто не брать плату за мягкие отказыАвтоматическое списание с каждого мягкого отказа означало бы, что платформа берет на себя все неудачные вызовы upstream. Что еще важнее, частые срабатывания upstream content safety также повышают риск блокировки учетной записи поставщика — это реальные издержки со стороны поставщика, которые мы не можем полностью устранить.Рекомендации для интеграторов
  • Предварительно фильтруйте и предупреждайте пользователей: добавьте фильтр по ключевым словам/сценариям на фронтенде или шлюзе (имена реальных людей, защищенные авторским правом персонажи, чувствительные темы) и показывайте подсказку в UI вроде “Celebrity / IP topics may fail and still be billed by upstream policy.” Это резко сокращает бесполезные списания.
  • Ежемесячное возмещение для consumer-продуктов: мы понимаем, что consumer-facing продукты не могут полностью ограничивать ввод пользователей. Если ваши ежемесячные расходы достаточно велики ($1000+/month), вы можете ежемесячно пакетно выгружать логи (вызовы с низкой задержкой обычно являются мягкими отказами) и обращаться в поддержку за разовым ручным кредитом — не нужно подавать апелляцию по каждому вызову.
📖 Связано: 500 errors are usually content-policy hits (not billed)
Сначала определите, потом обрабатывайте. Как подтверждено в июле 2026 года, возвращаемое b64_json — это raw base64 без префикса data:: декодируйте его, чтобы записать файл, или добавьте префикс сами перед рендерингом; ранние версии действительно включали префикс. Добавьте в код проверку startsWith('data:'): если префикс присутствует, используйте значение напрямую как img src; если нет, сначала декодируйте или добавьте префикс — это предотвращает двойное добавление префикса или декодирование строки с префиксом в поврежденное изображение.
Рекомендуется ≤ 10MB на изображение, форматы png / jpg / webp. Слишком большие изображения могут упереться в лимиты шлюза. Каждое изображение при слиянии нескольких изображений должно соответствовать этому ограничению.
Поле url ответа в режиме url — это ссылка R2 CDN, которая истекает примерно через 1 день (24 часа); запросы после этого вернут 404.Настоятельно рекомендуется: сразу после генерации скачивайте и сохраняйте сгенерированные изображения в собственное object storage (S3 / OSS / R2), CDN или базу данных.
Нет. Эта модель возвращает изображение за один раз; streaming не поддерживается. Если важна задержка, показывайте на стороне клиента индикатор прогресса «generating…» и настройте тайм-аут 300с (с запасом).
Да. Укажите base_url на https://api.apiyi.com/v1 и установите api_key в ваш token APIYI. client.images.generate(model="gpt-image-2-vip", size="2048x1360", prompt=...) работает напрямую.
Да, эндпоинт по-прежнему работает, но больше не рекомендуется — вместо этого используйте /v1/images/generations и /v1/images/edits (так стабильнее, и тот же код работает с официальным релеем gpt-image-2).Стиль на основе chat имеет смысл только в двух сценариях: многошаговое итеративное редактирование или передача онлайн URLs изображений напрямую. Учтите, что когда намерение на изображение неоднозначно, модель может вернуть обычный текст вместо изображения (добавьте перед prompt фиксированный префикс вроде “Generate an image:”, чтобы усилить запрос).Полные параметры см. в справке по chat-based API.
Когда вам нужен переключатель quality (low/medium/high), локальная перерисовка на основе маски или строгое соответствие полям OpenAI-API — используйте gpt-image-2. См. Сравнение Official и Reverse.

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

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