Обзор
На этой странице рассматривается серия GPT-Image 2.5 / 2 от OpenAI через официальный релей APIYI:gpt-image-2.5-flare (с приоритетом скорости), gpt-image-2.5-sunburst (с приоритетом качества и точности редактирования) и gpt-image-2 предыдущего поколения. Модели 2.5 выпущены 2026-09-08 и обеспечивают более высокое качество по сравнению с gpt-image-2, более точное редактирование и два новых уровня quality (xhigh / max) при абсолютно тех же цене и параметрах, что и у gpt-image-2. Для всей серии общими являются: любое допустимое разрешение (включая 2K / 3840×2160 4K), автоматическое высокоточное качество при работе с эталонными изображениями, тарификация по token. Шлюз APIYI полностью совместим с API изображений OpenAI — укажите base_url официального SDK OpenAI здесь для прямого подключения без изменений в коде.
xhigh / max в версии 2.5. Оптимально для производственных сценариев, требующих точного управления размером и качеством, полной совместимости с официальным API OpenAI или вывода в 4K; по умолчанию для преобразования текста в изображение используйте gpt-image-2.5-flare, а для редактирования — gpt-image-2.5-sunburst.API преобразования текста в изображение
/v1/images/generations — генерация изображений из текстовых промптов с управлением размером, качеством и output_format.API редактирования изображений
/v1/images/edits — загрузка эталонных изображений в формате multipart (до 16 изображений) и инструкций по редактированию или объединению с поддержкой дорисовки по маске.Позвольте AI-агенту выполнить интеграцию
.md к любому URL документации), а затем пишет код в используемом в вашем проекте стеке — четыре наиболее частые проблемы (тайм-аут, отображение base64, сжатие при загрузке, уровень качества) уже учтены в требованиях.Попросите агента-программиста интегрировать или устранить неполадки в работе GPT-Image 2.5 / серии 2 для преобразования текста в изображение и редактирования изображений. Скопируйте и вставьте этот текст в Codex, Claude Code, Cursor и аналогичные инструменты.
От каких проблем защищает этот промпт
От каких проблем защищает этот промпт
Почему стоит выбрать официальный релей APIYI для GPT-image-2?
Построен на официальном канале OpenAI и глубоко оптимизирован для корпоративных production-нагрузок по направлениям надежности, стоимости и опыта интеграции:Официальный канал · Как у официального
Без ограничений на параллельные запросы
Та же цена + скидка до 15%
Глобальный доступ без барьеров
api.apiyi.com из отечественных дата-центров, домашнего широкополосного интернета или зарубежных узлов — стабильная задержка, без трансграничной перестройки архитектуры.Полная линейка моделей
gpt-image-2-all ($0.03 за изображение, фиксированная цена), или на самый выгодный по стоимости Nano Banana Pro / 2 — комбинируйте варианты под каждый сценарий.Профессиональная корпоративная поддержка
Выбор модели: flare / sunburst / gpt-image-2
С 2026-09-08 эта группа документации охватывает три модели OpenAI GPT-Image 2.5 / 2. Все три используют одинаковые цены, параметры, группы и эндпоинты; переключение выполняется изменением одного поляmodel:
Основные возможности
Любое разрешение (вкл. 4K)
Автоматическая высокая точность
input_fidelity (иначе будет ошибка).На 20-30% дешевле
Китайский + рендеринг текста
high.Слияние нескольких изображений (до 16)
image[] массив принимает до 16 референсных изображений. Используйте «image 1 / image 2 / image 3» в prompt, чтобы сослаться на них по порядку загрузки.Маскирование inpainting
Несколько форматов вывода
output_compression для jpeg/webp, чтобы управлять размером файла.Прямой доступ через OpenAI SDK
base_url на https://api.apiyi.com/v1 и вызывайте напрямую с официальным OpenAI SDK — миграция без кода.Тарификация
gpt-image-2.5-flare / gpt-image-2.5-sunburst / gpt-image-2 APIYI (группа по умолчанию) используют единый прайс-лист, который в точности соответствует официальным тарифам OpenAI — скидка предоставляется за счёт нашего бонуса за пополнение: пополните счёт на $100 и получите бонус 10%, вплоть до 20%. 📖 Подробнее об акциях пополнения.
Тарификация по количеству token (как в прайс-листе OpenAI)
Token-metered — один запрос = токены входного текста + входного изображения + выходного изображения:Справочник стоимости за изображение (официальная таблица, gpt-image-2)
Типичная стоимость одного изображения дляgpt-image-2 при предустановленных размерах 1K (модели 2.5 используют другое количество tokens для тех же названий уровней; см. следующий раздел):
- Цены за единицу соответствуют прайс-листу OpenAI; добавьте бонус за пополнение (10% при пополнении на $100, до 20%), и итоговая стоимость будет ниже, чем при прямой оплате
- Для 2K / 4K нет фиксированной цены за изображение — тарификация выполняется по фактическому количеству входных и выходных tokens
- Запросы на редактирование имеют заметно больше входных tokens, чем преобразование текста в изображение, из-за принудительного режима высокой точности
- Потоковая передача (
stream: true+partial_images: N) стоит дополнительно 100 выходных tokens изображения за каждый частичный результат - По сравнению с
gpt-image-1.5при одинаковых размере и качестве,gpt-image-2примерно на 20–30% дешевле
Уровни качества и измеренная стоимость для моделей 2.5 (измерено 2026-09-09)
Одинаковое название уровня не означает одинаковое число token в 2.5 и gpt-image-2: 2.5 заново калибрует шкалу качества.low не изменяется, high у 2.5 соответствует medium у gpt-image-2, а max у 2.5 соответствует high у gpt-image-2. В таблице показаны usage.output_tokens и стоимость вывода при тарифе $30 / 1 млн token для преобразования текста в изображение размером 1024×1024, с одинаковым prompt и одним последовательным запуском для каждой модели (flare и sunburst дают одинаковое число token для каждого уровня; различается только задержка):
Как несколько входных изображений влияют на цену (проверено в июле 2026)
Частый вопрос от клиентов: «Каждое референсное изображение стоит фиксированную сумму, или большие изображения расходуют больше tokens?» Ответ: важны оба фактора, и количество изображений суммируется строго линейно.gpt-image-2 обрабатывает каждое входное изображение в принудительном режиме высокой детализации (input_fidelity не настраивается — при его передаче возвращается 400), и каждое референсное изображение преобразуется в image tokens в зависимости от его размеров и aspect ratio. Контролируемые измерения (эндпоинт edits, 2026-07-15):
- Количество строго линейно: N референсных изображений ≈ N × tokens одного изображения. 16 референсных изображений при 1024² ≈ 16384 tokens ≈ $0.13 — тот же порядок величины, что и один вывод
high($0.211), так что в случае слияния нескольких изображений этим уже нельзя пренебрегать. - Размер имеет и нижний предел, и потолок: квадратные изображения размером 1024² и меньше тарифицируются как 1024 tokens (уменьшение до 512 ничего не экономит); 2048² и 4096² оба стоят 1521 tokens (слишком большие изображения перед преобразованием уменьшаются — потолок действует). Одно референсное изображение обычно попадает примерно в диапазон 800-1600 tokens с учетом соотношения сторон.
- Tokens определяются размерами в пикселях, а не размером файла: сжатие до 1.5MB помогает со стабильностью и скоростью загрузки, но не уменьшает image tokens; наоборот, загрузка исходника на 50MB тоже не раздует ваш счет (действует потолок).
Оценка стоимости 2K/4K (экстраполяция по соотношению пикселей, ⚠️ не официальная фиксированная цена)
OpenAI публикует только фиксированную таблицу цены за изображение для размеров 1K — для 2K/4K нет официальной помодельной цены по размеру. Приведенная ниже таблица — это собственная экстраполяция APIYI на основе официальных ставок 1K выше, масштабированная по числу пикселей, и она предназначена только для планирования бюджета:Чем это отличается от SaaS-подписки / тарификации на основе credit
Вендоры инструментов генерации изображений обычно тарифицируют по одной из двух схем:- Ежемесячные планы подписки: фиксированная ежемесячная плата за квоту «N изображений в месяц». Эта квота рассчитывается исходя из предположения о сверхпродаже — вендор закладывает ожидание, что большинство пользователей не израсходует весь лимит, поэтому рекламируемая «стоимость за изображение» — это просто цена плана, деленная на верхний предел квоты, а не то, сколько на самом деле стоит сгенерировать для вас одно изображение.
- Учёт на основе credit / point: задачи разного качества и размера переводятся в неочевидные «credits». По сути это тарификация по фактическому использованию, просто переупакованная в единицу credit, которая скрывает реальное потребление token.
Как проверить фактическое количество token для каждого вызова
И/v1/images/generations, и /v1/images/edits возвращают поле usage, а token входного изображения и token входного текста возвращаются как отдельные поля — ничего оценивать не нужно, просто считайте их, чтобы получить точную стоимость каждого вызова. Вот полный объект usage из реального запроса на редактирование с одним референсным изображением (зафиксировано в реальном времени):
Настройка группы
Все три модели GPT-Image 2.5 / 2 используют одни и те же группы официального релея. Переключение выполняется в панели управления → Настройки token → Группа:image2Enterprise, чтобы переждать всплеск нагрузки.

Token settings: pick the image2Enterprise group (1.2x) — stable when default capacity is tight
Технические характеристики
Эндпоинты
Справка по размерам
Предустановленные размеры
Ограничения пользовательского размера
gpt-image-2 принимает любой допустимый размер, который соответствует всем условиям:
- Макс. сторона ≤ 3840px
- Обе стороны кратны 16
- Соотношение сторон ≤ 3:1
- Общее число пикселей ∈ [655,360, 8,294,400] (~0.65MP до ~8.3MP)
1600x1200, 1792x1024, 2048x1536, 3200x1800
Недопустимые примеры: 1000x1000 (не кратно 16), 4000x4000 (выше максимума), 3840x1000 (соотношение > 3:1)
Справочник качества
Доступные уровни
quality оказывает наибольшее влияние на цену — больше, чем size. Количество токенов выходного изображения определяется параметром quality × size, но quality имеет гораздо больший вес: при одинаковом размере переход от low к high может изменить стоимость одного изображения более чем в 30 раз (см. приведённую выше таблицу «стоимость изображения»: для gpt-image-2 при размере 1024×1024 она варьируется от low $0.006 до high $0.211; для моделей версии 2.5 — от low $0.006 до max $0.211). Сначала оценивайте стоимость по параметру quality, а затем учитывайте влияние size.Лучшие практики
Сначала интегрируйте вариант с низким качеством
quality=low + предустановленного размера, чтобы проверить всю цепочку вызова (аутентификация, параметры, тайм-ауты, обработка ошибок). low в несколько раз быстрее high, поэтому функциональные проблемы обнаруживаются быстро и не маскируются длительной задержкой.Предпочитайте предустановленные размеры
Соотносите качество со сценарием
low; повседневное использование / финальный результат → medium; текст, мелкие текстуры, печать → high. Обратите внимание, что переход от low к high означает не только повышение визуальной точности — это также существенное увеличение сложности инференса, поэтому задержка растёт соответствующим образом.Выбирайте формат JPEG
output_format=jpeg + output_compression=85 работает быстрее PNG и занимает примерно вдвое меньше места.Используйте высокий уровень для сценариев с текстом
quality=high.Подготовьте референсные изображения
Настройте тайм-аут клиента по уровням (для высокого уровня → защитный предел 600 с)
quality и size, особенно quality. Настройте тайм-ауты клиента для каждого уровня:high установите тайм-аут 600 с как защитный предел, чтобы учитывать очередь, разброс значений в длинном хвосте распределения и нестабильность upstream. Показывайте ход выполнения в интерфейсе; рассмотрите возможность использования серверной очереди задач.Примечания по миграции
gpt-image-1.5 удалите input_fidelity (принудительно включает высокую точность и вызывает ошибку при передаче); background: transparent продолжит работать как прежде, изменений не требуется. При миграции с устаревшего кода DALL·E 2/3: удалите response_format (модели GPT Image отклоняют его с ошибкой 400 Unknown parameter: 'response_format'; формат вывода всегда b64_json).Ошибки и повторные попытки
- Устанавливайте таймаут запросов по уровням
quality:low≥ 120 секунд /medium≥ 240 секунд /high≥ 600 секунд (страховочный запас — наблюдалось 3–5 минут; настройка около 120s/360s вызывает много ложных таймаутов) - Сначала интегрируйтесь с
quality=low, затем переходите наmedium/highпо мере реальной необходимости в качестве - Экспоненциальная задержка для 5xx и таймаутов (рекомендуем 2 повтора)
- Логируйте заголовок
x-request-idдля поддержки
Часто задаваемые вопросы
Как исправить ошибку 400 Unknown parameter: 'response_format'?
Как исправить ошибку 400 Unknown parameter: 'response_format'?
response_format — сейчас это самая распространённая ошибка 400. gpt-image-2 (и вся серия GPT Image) не принимает response_format: формат вывода фиксирован на b64_json и не может быть изменён. Его передача возвращает:url / b64_json), и множество старых примеров кода и некоторые сторонние библиотеки по-прежнему добавляют его по умолчанию. При переходе на gpt-image-2 удалите это поле и считывайте data[0].b64_json напрямую (необработанный base64 — декодируйте его, чтобы получить файл изображения). Ошибка возвращается на этапе проверки входных данных и не тарифицируется.Если вашему рабочему процессу действительно нужен URL изображения, а не base64:- Официальный
gpt-image-2не поддерживает вывод URL — декодируйте base64 и загрузите файл в собственное объектное хранилище - Либо переключитесь на реверс-инжиниринговый
gpt-image-2-all, который поддерживаетresponse_format: "url"и возвращает CDN-ссылку, действительную в течение 24 часов
Нужно ли добавлять префикс data:image/png;base64, к b64_json?
Нужно ли добавлять префикс data:image/png;base64, к b64_json?
gpt-image-2 возвращает необработанную строку base64 (без префикса), в отличие от gpt-image-2-all. Два варианта работы на стороне клиента:- Запись файла:
base64.b64decode(b64_str)→ запись на диск - Отображение в браузере:
img.src = 'data:image/png;base64,' + b64_str(добавьте префикс вручную)
Почему передача input_fidelity возвращает ошибку 400?
Почему передача input_fidelity возвращает ошибку 400?
gpt-image-2 принудительно включает высокоточное обрабатывание эталонных изображений и больше не принимает input_fidelity. При переходе с версии 1.5 просто удалите это поле — замена не требуется.Что делать, если нужен прозрачный фон?
Что делать, если нужен прозрачный фон?
background: "transparent", установив output_format в png или webp. В результате будет настоящее изображение с альфа-каналом — дополнительная постобработка для вырезания не требуется. Преобразование текста в изображение, редактирование изображений и инструмент изображений в Responses поддерживают эту возможность.Есть два ограничения: у jpeg нет альфа-канала, и он несовместим с прозрачностью (возвращает ошибку 400); кроме того, на эндпоинте редактирования прозрачность означает повторную отрисовку, а не точное обведение исходного контура, поэтому детали объекта могут измениться. Для попиксельно точного извлечения самостоятельно выполните rembg / PIL / sharp.Полные сведения и информацию о поддержке по моделям см. в разделе Как создавать изображения с прозрачным фоном.Сколько изображений можно создать за один вызов?
Сколько изображений можно создать за один вызов?
n=1). Для N изображений отправьте N параллельных запросов. Каждый запрос тарифицируется отдельно по количеству token.Почему 2K/4K работает так медленно?
Почему 2K/4K работает так медленно?
quality=high + высокое разрешение занимают примерно 235 секунд (около 4 минут) на одно изображение, а длительный хвост задержки для 3840×2160 + high может достигать почти 5 минут. Рекомендации:- Сначала интегрируйте
quality=low, чтобы проверить цепочку вызовов, а затем повышайте параметры по мере возникновения реальной потребности в качестве - Установите тайм-аут клиента в зависимости от качества:
low≥ 120 с /medium≥ 240 с /high≥ 600 с (резерв безопасности) - Показывайте в интерфейсе прогресс «генерации»
- Используйте пресеты 1K 1024×1024 / 1536×1024, если 4K не требуется
Действительно ли я получу выгоду от тарификации кэшированных входных данных?
Действительно ли я получу выгоду от тарификации кэшированных входных данных?
Почему запросы на редактирование стоят дороже, чем преобразование текста в изображение?
Почему запросы на редактирование стоят дороже, чем преобразование текста в изображение?
gpt-image-2 автоматически включает высокоточное обрабатывание эталонных изображений, сами эталонные изображения преобразуются в большое количество входных token согласно правилам тарификации Vision. Количество входных token при редактировании заметно выше, чем при преобразовании текста в изображение, поэтому учитывайте это при планировании бюджета.Одинаковые размеры и эталонные изображения — почему каждый вызов всё равно стоит по-разному?
Одинаковые размеры и эталонные изображения — почему каждый вызов всё равно стоит по-разному?
quality было установлено в auto (или не указано). Клиенты сообщали: «размер, разрешение и эталонные изображения идентичны, но цена то увеличивается, то уменьшается». При проверке оказалось, что и size, и quality были установлены в auto.Причина — quality: auto: в автоматическом режиме модель интерпретирует запрос и выбирает другой уровень качества для каждой генерации. Другой уровень означает другое количество выходных token изображения, а значит, и другую цену. Ниже приведены три реальные записи тарификации с идентичными входными данными (по 1061 входному token в каждой), но стоимостью, различающейся в несколько раз:auto определило более высокий уровень качества, количество выходных token выросло до 5146, а цена увеличилась примерно в 3,5 раза.Исправление: не оставляйте quality в состоянии auto — явно передавайте low / medium / high. При фиксированном уровне количество выходных token и цена для одинаковых входных данных становятся стабильными и предсказуемыми. См. раздел «Справочная информация о качестве» выше.Каковы ограничения на количество и размер изображений для эндпоинта редактирования?
Каковы ограничения на количество и размер изображений для эндпоинта редактирования?
gpt-image-2 (/v1/images/edits) поддерживает до 16 эталонных изображений:- Загрузка файла через multipart/form-data: размер каждого изображения должен быть менее 50 МБ, форматы
png/jpg/webp - URL данных base64: ограничение длины поля составляет около 20 МиБ (схема
maxLength: 20971520— это ограничение строкового поля, не совпадающее с ограничением 50 МБ для multipart), поэтому размер исходных изображений должен быть не более 15 МБ - Файл маски: отдельное ограничение — PNG размером менее 4 МБ
Эндпоинт редактирования возвращает ошибку 400 «Invalid image file or mode for image 1» — что делать?
Эндпоинт редактирования возвращает ошибку 400 «Invalid image file or mode for image 1» — что делать?
code: invalid_image_file) означает: N-е эталонное изображение не является стандартным файлом png / jpg / webp (индексация начинается с 1 — используйте индекс, чтобы найти проблемное изображение).Наиболее распространённая первопричина — формат MPO в камерах телефонов: файлы .jpg, непосредственно полученные с телефонов серии Huawei Mate, содержат дополнительный кадр HDR gain-map и фактически являются многоракурсными контейнерами JPEG (MPO). Заголовок совпадает с FFD8, а расширение и команда file сообщают о формате JPEG — визуально это невозможно определить. Проверено в июле 2026 года: файлы MPO всегда отклоняются, а те же изображения, перекодированные в стандартный JPEG/PNG, успешно обрабатываются в полном исходном разрешении (это не связано с размерами, именем поля image[] или параметрами quality/size). Ошибка возвращается на этапе проверки входных данных и не тарифицируется.Исправление: перекодируйте изображение с помощью Pillow перед загрузкой (если Image.open(f).format возвращает "MPO", требуется преобразование):Как подготовить файл маски?
Как подготовить файл маски?
- Тот же размер, что и у исходного изображения, формат PNG, менее 4 МБ
- Должен иметь альфа-канал: прозрачная область (alpha=0) = область для дорисовки, непрозрачная = сохранить
- Применяется только к первому изображению
- Маска — это «мягкая направляющая»: модель может расширить или сузить область вокруг замаскированного участка
gpt-image-2 и gpt-image-2-all: что выбрать?
gpt-image-2 и gpt-image-2-all: что выбрать?
Можно ли напрямую использовать официальный SDK OpenAI?
Можно ли напрямую использовать официальный SDK OpenAI?
base_url значение https://api.apiyi.com/v1 и установите api_key равным вашему токену APIYI:Можно ли отменить выполняющуюся генерацию?
Можно ли отменить выполняющуюся генерацию?
gpt-image-2 использует официальный синхронный эндпоинт OpenAI — после отправки запроса он выполняется до завершения, поскольку сигнал «отмена» не предусмотрен. Даже если клиент отключится, сервер всё равно завершит генерацию и выполнит обычную тарификацию. Внимательно настройте тайм-ауты на стороне клиента — не предполагайте, что «отключение = отсутствие платы».Есть ли лимит запросов (RPM)?
Есть ли лимит запросов (RPM)?
Поддерживается ли асинхронный вызов?
Поддерживается ли асинхронный вызов?
gpt-image-2 полностью повторяет официальный API OpenAI и работает только синхронно. Запрос блокируется до возврата результата (high + 4K — на практике 1–2 минуты). Если вам нужна асинхронная очередь или механизм обратных вызовов:- Реализуйте его самостоятельно с помощью очереди задач (Celery / BullMQ и т. п.) на уровне бизнес-логики
- Либо используйте
gpt-image-2-all— генерация занимает 30–60 с, а опрашивать этот сервис из интерфейса проще
Тарифицируются ли неудачные генерации?
Тарифицируются ли неудачные генерации?
400, и плата не взимается. Типичный ответ:401 (недействительный токен), 429 (лимит запросов). Тарификация token начинается только после того, как запрос фактически достигает этапа генерации модели (то есть получены 200 + b64_json).Связанные документы
- ⚖️ Сравнение официальных и реверс-инжиниринговых решений — руководство по выбору с параллельным сравнением
- Песочница преобразования текста в изображение — интерактивное тестирование
/v1/images/generations - Песочница редактирования изображений — объединение нескольких изображений
/v1/images/edits+ маска - Подробный обзор: GPT-image-2.5 запускается, Flare работает быстрее, Sunburst отличается большей резкостью — новостная статья
- Подробный обзор: запуск gpt-image-2 — новостная статья
- Полная документация по интеграции — полное справочное руководство по API
- GPT-Image-2-All (реверс-инжиниринг) — более доступная и быстрая альтернатива
- Сообщество: узлы Luck GPT-Image 2 для ComfyUI — вызывайте
gpt-image-2напрямую в ComfyUI (маска / 5 эталонных изображений / пользовательские размеры) - Сообщество: навыки APIYI GPT-Image 2 — вызывайте из Codex CLI / Cursor / Gemini CLI и других инструментов для разработки с использованием ИИ одной фразой
- Руководство по API — общее руководство по использованию
gpt-image-2.5-flare / gpt-image-2.5-sunburst / gpt-image-2 — это официальные модели OpenAI, тарифицируемые по token. Если для вас важны фиксированная тарификация ($0.03/изображение) и более быстрая генерация (30–60 с), см. gpt-image-2-all.