Skip to Content
МоделиGPT ImageОбзор

Семейство GPT Image

Модели генерации изображений от OpenAI: gpt-image-2.5-flare, gpt-image-2.5-sunburst и gpt-image-2. Все три вызываются через OpenAI-совместимый API.

Все данные в этом разделе получены на реальном API, а каждый пример кода был запущен в неизменном виде. Последняя проверка: 2026-09-30.

Что вы хотите сделать?

Текст в изображение Сгенерировать изображение по текстовому промпту.Редактирование и объединение Загрузить одно или несколько изображений и изменить или объединить их по промпту.Инпейнтинг Отметить область маской и перерисовать только её.Генерация в ваших инструментах Без кода. Заполните несколько настроек в Cherry Studio или LobeHub либо скопируйте один промпт в Claude Code или Codex.

Общая структура запроса и поля ответа для этих эндпоинтов описаны в разделе Images API.

Какую модель выбрать

gpt-image-2.5-flareТекст в изображение
  • Повседневная и пакетная генерация; быстрая
  • 6 уровней качества: от low до max
Azure · OpenAI
gpt-image-2.5-sunburstРедактирование
  • Редактирование и объединение изображений; более высокая точность
  • 6 уровней качества: от low до max
Azure · OpenAI
gpt-image-2Предыдущее поколение
  • Подходит для существующих проектов
  • 4 уровня качества; нет xhigh и max
Azure · OpenAI

При переходе с gpt-image-2 на 2.5 выберите уровень качества заново — см. раздел Качество и цена ниже. Оба провайдера поддерживают генерацию по тексту и редактирование, а шлюз маршрутизирует запросы автоматически.

Идентификаторы моделей (копируйте без изменений)
Текст в изображениеopenai/gpt-image-2.5-flareПовседневная и пакетная генерация; быстрая
Редактированиеopenai/gpt-image-2.5-sunburstРедактирование и объединение изображений; более высокая точность
Предыдущее поколениеopenai/gpt-image-2Нет уровней xhigh и max

Качество (quality) и цена

Сильнее всего на цену влияет quality. Чем выше уровень, тем дороже и дольше.

Официальные справочные цены OpenAI (за изображение, только выходное изображение; промпт и референсные изображения не учитываются):

Уровеньgpt-image-2 · 1024×1024gpt-image-2 · 1024×1536 или 1536×1024
low$0.006$0.005
medium$0.053$0.041
high$0.211$0.165

Для двух моделей 2.5 OpenAI не публикует таблицу цен за изображение. Вместо этого указаны цены за единицу: $30 за миллион выходных токенов изображения, $8 за миллион входных токенов референсных изображений и $5 за миллион входных текстовых токенов. Пример расчёта от OpenAI: изображение 1024×1024 на уровне low даёт 196 выходных токенов, около $0.00588. Для других уровней и размеров оцените стоимость с помощью официального калькулятора .

Это официальные данные OpenAI; фактическое списание определяется полем usage в каждом ответе. Актуальные цены OfoxAI (с учётом скидок) указаны на странице модели .

Уровни, поддерживаемые каждой моделью:

Уровень2.5 (flare, sunburst)gpt-image-2
low / medium / highПоддерживаетсяПоддерживается
xhigh / maxПоддерживаетсяНе поддерживается; возвращает 400
auto или не указанРешает модель — это не то же самое, что medium; указывайте явноАналогично

standard и hd (старые значения DALL·E) не поддерживаются и возвращают 400.

Задержка и таймауты (timeout)

API синхронный: ответ возвращается только после того, как изображение сгенерировано. Если клиент разорвёт соединение раньше, изображение будет потеряно, но запрос всё равно будет оплачен.

Запрос отправленГенерация — может занять несколько минутИзображение получено
60 / 120 с типичные значения по умолчанию: соединение обрывается во время генерации, изображение теряется, а запрос оплачивается
600 с рекомендуется: ожидание до получения изображения

Установите таймаут клиента 600 секунд. Задержка зависит от модели, качества и размера; запросы с высоким качеством, большим размером и редактирование могут занимать несколько минут, и типичных таймаутов по умолчанию в 60 или 120 секунд недостаточно.

Размер (size)

size принимает произвольное значение ШИРИНАxВЫСОТА при условии, что выполняются все четыре правила ниже; нарушение любого из них возвращает 400.

Кратно 16
  • Ширина и высота делятся на 16
✗ 1000x1000
Длинная сторона ≤ 3840
  • Ни одна сторона не превышает 3840
✗ 4096x4096
Соотношение сторон ≤ 3:1
  • От 1:3 до 3:1
✗ 3200x1024
Пикселей ≥ 655 360
  • Не менее 655 360 пикселей в сумме
✗ 768x768 → ✓ 1024x768

Если параметр не указан или равен auto, размер выбирает модель. Не гарантируется, что это будет 1024×1024 или что размер совпадёт с референсным изображением. В наших тестах и генерация по тексту, и редактирование вернули 1254×1254. Если нужен фиксированный размер, указывайте его явно.

Документированный максимум — 3840×2160; всё, что больше 2560×1440, отмечено как экспериментальное.

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

ПараметрЗначение
ОтветСинхронный; изображение передаётся как чистый base64 в data[0].b64_json
Размер выводаПроизвольные ширина и высота в рамках четырёх ограничений; до 3840×2160
Уровни качестваСм. Качество и цена
Формат выводаpng (по умолчанию), jpeg, webp
Изображений за запрос1–10, по умолчанию 1
Референсные изображения≤ 15 МБ каждое, ≤ 50 МБ на запрос — см. Ограничения загрузки
ТаймаутУстановите таймаут клиента 600 секунд — см. Задержка и таймауты

Выбор провайдера

Обычно это не требуется. Выбирайте провайдера, если у вас есть требования к модерации контента: провайдеры применяют разные пороги модерации; например, для gpt-image-2 модерация строже в Azure и сравнительно мягче в OpenAI.

Не выбран (рекомендуется)
Запрос→Шлюз OfoxAI→AzureOpenAI

Шлюз автоматически выбирает доступного провайдера из Azure и OpenAI.

Провайдер выбран
Запросopenai→Шлюз OfoxAI→AzureOpenAI

Запросы направляются только этому провайдеру; если он недоступен, переключения на другого провайдера не произойдёт.

Как выбрать провайдера
ЗаголовокX-OfoxAI-Provider-Type: openaiРаботает и для генерации по тексту, и для редактирования; значения: azure_foundry, openai
Тело запроса"extra_body": { "provider": { "type": "openai" } }Только для генерации по тексту; редактирование — это multipart-загрузка, поэтому принимается только заголовок

Подробнее: Маршрутизация провайдеров.

Распространённые ошибки

ОшибкаПричинаРешение
moderation_blocked (Your request was rejected by the safety system)Промпт или референсное изображение заблокированы системой безопасности на стороне поставщика моделиИзмените промпт или референсное изображение и повторите попытку; повтор без изменений даст тот же результат. Если у вас есть требования к модерации, рассмотрите выбор провайдера
Таймаут, 504, 524, Request timed outКлиент или промежуточный прокси (Nginx, Vercel, Cloudflare и т. п.) прерывает ожидание до окончания генерацииУстановите таймауты клиента и прокси 600 секунд — см. Задержка и таймауты
404 model_not_foundОшибка в написании идентификатора модели или неверный регистр, например GPT-Image-2Скопируйте идентификатор модели с этой страницы, всё в нижнем регистре
provider_type_unavailableУказанный вручную провайдер не обслуживает эту модельУдалите параметр провайдера и позвольте шлюзу выполнить маршрутизацию
unknown provider typeОшибка в имени провайдера в заголовкеПроверьте написание
Invalid sizeРазмер нарушает одно из четырёх правилСм. Размер
does not support quality 'xhigh'xhigh или max отправлены для gpt-image-2Используйте high или перейдите на 2.5
Invalid value: 'standard'Для quality указано standard или hdИспользуйте значения от low до max
Invalid image file or modeРеференсное изображение или маска в неверном форматеПересохраните как стандартный PNG или JPEG
Invalid file 'image[0]': unsupported mimetypeЗагруженный файл не является изображениемЗагрузите изображение PNG, JPEG или WebP
does not support the 'input_fidelity' parameterЗапрос на редактирование содержит input_fidelityУдалите его. Модели 2.5 и gpt-image-2 всегда обрабатывают референсные изображения с высокой точностью
Transparent background is not supported for JPEG output formatЗапрошен прозрачный фон при выводе в jpegИспользуйте png или webp
Unknown parameterПараметр не поддерживается этим семействомУдалите его
429 rate_limit_exceededБолее 100 запросов в минуту (на команду)Повторите попытку позже. Дополнительные ключи не повышают лимит

Полный справочник ошибок: Обработка ошибок.

Точные тексты ошибок

Полные сообщения, полученные при замерах, — для поиска и сравнения:

Invalid size '1000x1000'. Width and height must both be divisible by 16.
Invalid size '4096x4096'. The longest edge must be less than or equal to 3840.
Invalid size '3200x1024'. The maximum supported aspect ratio is 3:1.
Invalid size '768x768'. Requested resolution is below the current minimum pixel budget.
The model 'gpt-image-2' does not support quality 'xhigh'.
Invalid value: 'standard'. Supported values are: 'low', 'medium', 'high', and 'auto'.
Invalid 'n': integer above maximum value. Expected a value <= 10, but got 11 instead.
Unknown parameter: 'style'.
The model 'gpt-image-2.5-sunburst' does not support the 'input_fidelity' parameter.
Transparent background is not supported for JPEG output format
Invalid file 'image[0]': unsupported mimetype ('text/plain; charset=utf-8'). Supported file formats are 'image/jpeg', 'image/png', and 'image/webp'.
unknown provider type in X-OfoxAI-Provider-Type header
Model 'GPT-Image-2' not found
Invalid image file or mode for image 1

Обратите внимание: список допустимых значений в Invalid value: 'standard' неполный — модели 2.5 также принимают xhigh и max. Ориентируйтесь на таблицу уровней на этой странице.

Параметры, которые не действуют

Эти параметры не вызывают ошибку, но для этого семейства ни на что не влияют. Запрос выполняется успешно и оплачивается как обычно:

ПараметрПричина
mask (при генерации по тексту)Работает только на эндпоинте редактирования
response_formatСтарый параметр DALL·E; это семейство всегда возвращает base64 (b64_json). При прямом обращении к OpenAI возвращается Unknown parameter: 'response_format'; через OfoxAI параметр игнорируется
input_fidelity (при генерации по тексту)Относится к gpt-image-1.5. Обратите внимание: на эндпоинте редактирования он возвращает 400
input_imagesОтносится к семейству Qwen Image

Отсутствие ошибки не означает, что параметр сработал: например, style отклоняется сразу, а перечисленные выше параметры молча игнорируются.

Официальная документация

Документация OpenAI описывает поведение при прямом обращении к OpenAI. При вызове через OfoxAI приоритет имеют результаты замеров из этого раздела. Например, стоимость определяется полем usage в ответе и страницами моделей.

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

Принимает ли GPT Image 2.5 любой размер?

Принимает произвольные размеры при соблюдении четырёх правил: ширина и высота делятся на 16, длинная сторона не более 3840, соотношение сторон от 1:3 до 3:1 и не менее 655 360 пикселей в сумме. Нарушение любого правила возвращает 400. Например, 768x768 содержит слишком мало пикселей и отклоняется, а 1024x768 работает.

Какой размер я получу, если не укажу size?

Размер выбирает модель. Это не обязательно 1024x1024 и не обязательно размер референсного изображения. В наших тестах и генерация по тексту, и редактирование вернули 1254x1254. Если нужен фиксированный размер, указывайте его явно.

Поддерживает ли gpt-image-2 качество xhigh и max?

Нет, оба значения возвращают 400. xhigh и max поддерживаются только моделями gpt-image-2.5-flare и gpt-image-2.5-sunburst. gpt-image-2 принимает low, medium, high и auto.

Можно ли указать для GPT Image 2.5 качество hd или standard?

Нет, эти значения возвращают 400. Допустимые значения: low, medium, high, xhigh, max и auto. Если параметр не указан, модель выбирает уровень сама (в наших тестах — low), поэтому для стабильного качества указывайте его явно.

Какой таймаут установить для API gpt-image-2 / GPT Image 2.5?

Установите таймаут клиента 600 секунд. Задержка зависит от модели, качества и размера; запросы с высоким качеством, большим размером и редактирование могут занимать несколько минут.

Как исправить ошибку GPT Image moderation_blocked (Your request was rejected by the safety system)?

Промпт или референсное изображение заблокированы системой безопасности на стороне поставщика модели — как правило, из-за реальных людей, персонажей, защищённых авторским правом, или чувствительного контента. Измените промпт или референсное изображение и повторите попытку; повтор без изменений даст тот же результат. Поле error.moderation_details в ответе показывает, на каком этапе произошла блокировка — на входе или на выходе. Провайдеры применяют разные пороги модерации, поэтому при наличии требований к модерации рассмотрите выбор провайдера.

Как исправить ошибку GPT Image Unknown parameter: response_format?

response_format — старый параметр DALL·E. GPT Image возвращает только base64 (data[0].b64_json) и не предоставляет URL изображений. Удалите response_format и используйте output_format, чтобы выбрать png, jpeg или webp. Через OfoxAI этот параметр игнорируется и не вызывает ошибку.

Что делать с сообщением «Your organization must be verified» при вызове gpt-image?

Это верификация организации, которую OpenAI требует при прямом доступе. При работе через OfoxAI проходить верификацию организации самостоятельно не нужно: с API-ключом OfoxAI можно вызывать gpt-image-2.5-flare, gpt-image-2.5-sunburst и gpt-image-2.

Что делать, если запросы GPT Image завершаются по таймауту или возвращают 504 или 524?

API синхронный, и запросы с высоким качеством, большим размером и редактирование могут занимать несколько минут. Установите таймаут клиента 600 секунд и проверьте таймауты промежуточных прокси, таких как Nginx, Vercel или Cloudflare: по умолчанию они часто составляют всего 60–100 секунд.

Как исправить ошибку GPT Image does not support the input_fidelity parameter?

GPT Image 2.5 и gpt-image-2 всегда обрабатывают референсные изображения с высокой точностью, поэтому эндпоинт редактирования не принимает input_fidelity. Удалите его; этот параметр применим только к gpt-image-1.5.

Как исправить ошибку GPT Image Invalid size?

Размер нарушает одно из четырёх правил, и сообщение указывает, какое именно: divisible by 16 — ширина или высота не кратна 16; longest edge — длинная сторона больше 3840; aspect ratio — соотношение сторон превышает 3:1; minimum pixel budget — меньше 655 360 пикселей, например 768x768. Используйте размер, удовлетворяющий всем четырём правилам, например 1024x768, 1024x1024 или 1536x1024.

Сколько стоит одно изображение GPT Image?

Оплата идёт за токены, и сильнее всего на цену влияет уровень качества. Официальные справочные цены OpenAI для изображения 1024x1024 с gpt-image-2: около $0.006 на low, $0.053 на medium и $0.211 на high. Для двух моделей 2.5 выходные токены изображения стоят $30 за миллион, поэтому 1024x1024 на low обходится примерно в $0.006. Фактическое списание определяется полем usage в ответе; актуальные цены OfoxAI указаны на страницах моделей.

Нужно ли закреплять провайдера при редактировании с GPT Image 2.5?

Нет. Эндпоинт редактирования 2.5 обслуживают и Azure, и OpenAI, а шлюз маршрутизирует запросы автоматически.

Last updated on
Текст в изображение