dall-e-3, модель с улучшенными возможностями рендеринга текста gpt-image-1, новейшее поколение gpt-image-2, а также серию моделей nano-banana / nano-banana-2 / nano-banana-pro, подключенных через тот же интерфейс. Все они способны создавать высококачественные изображения на основе текстовых описаний.
В этом документе описан процесс использования OpenAI Images Generations API, который позволяет легко применять возможности генерации изображений серии OpenAI.
Процесс подачи заявки
Для использования OpenAI Images Generations API сначала перейдите на страницу OpenAI Images Generations API и нажмите кнопку «Acquire», чтобы получить необходимые для запросов креденшелы:
Если вы не вошли в систему или не зарегистрированы, произойдет автоматический переход на страницу входа, где вы сможете зарегистрироваться и войти. После входа вы автоматически вернетесь на текущую страницу.
При первом запросе предоставляется бесплатный лимит для использования API.
Модель GPT-Image-2
gpt-image-2 — новая модель генерации изображений от OpenAI, которая по сравнению с dall-e-3 и gpt-image-1 имеет следующие улучшения:
- Лучшее следование инструкциям: точное понимание сложных структурных указаний, таких как композиция, подсчет объектов, позиционные отношения.
- Четкое рендеринг текста: английские слова и цифры на постерах, меню, инфографике и логотипах практически не искажаются.
- Более богатое стилевое исполнение: нативная поддержка различных стилей, включая кинематографичные портреты, винтажные постеры, детские иллюстрации, продуктовую фотографию, инфографику.
- Поддержка нескольких соотношений и высоких разрешений: 5 соотношений сторон (1:1, 4:3, 3:4, 16:9, 9:16) и 3 уровня разрешения (1K / 2K / 4K).
model со значением gpt-image-2. В ответе поле url содержит постоянную ссылку на изображение, размещённое на platform.cdn.xhuoapi.ai, которую можно открыть в браузере или встроить на веб-страницу.
Поддерживаемые значения size и уровни тарификации
gpt-image-2 проверяет только формат size: если значение не auto и не пустое, оно должно соответствовать формату WIDTHxHEIGHT (например, 1024x1024, 2048x1152, 800x600); любые другие форматы приведут к ошибке 400. Тарификация делится на два уровня:
- 1K стандартная цена: входное значение — любое из рекомендованных 1K размеров из таблицы ниже или распространённые 1K псевдонимы (
1254x1254,1672x941,941x1672— это фактические размеры, которые возвращает upstream, повторное использование не повлечёт повышение цены). - Другие размеры (1.5×): любые размеры, не входящие в 1K набор, включая рекомендованные 2K / 4K предустановки и любые пользовательские
WIDTHxHEIGHT.
| Соотношение | 1K (стандарт) | 2K рекоменд. (×1.5) | 4K рекоменд. (×1.5) |
|---|---|---|---|
| 1:1 | 1024x1024 | 2048x2048 | 2880x2880 |
| 4:3 | 1536x1024 | 2048x1536 | 3264x2448 |
| 3:4 | 1024x1536 | 1536x2048 | 2448x3264 |
| 16:9 | 1792x1024 | 2048x1152 | 3840x2160 |
| 9:16 | 1024x1792 | 1152x2048 | 2160x3840 |
Вы также можете передатьsize: "auto"или пропустить полеsize, тогда модель выберет размер по умолчанию, и тарификация будет по 1K стандарту. При 1K тарифе upstream не гарантирует точное соответствие пикселям — например, при передаче1024x1024может быть возвращено1254x1254с сохранением пропорций. Если вы повторно передадите полученный размер, тарификация останется 1K. Вызов с 4K обычно занимает 4–8 минут, рекомендуется использовать асинхронныйcallback_url(см. ниже).
О параметреНиже приведены реальные примеры, демонстрирующие возможностиnВgpt-image-2не поддерживаетсяn > 1: параметр игнорируется, независимо от значенияnвозвращается только 1 изображение и тарифицируется как одно. Для получения нескольких вариантов нужно запускать несколько параллельных запросов с разнымиpromptилиseed, иначе изображения будут похожи. Это ограничение также действует дляgpt-image-1/gpt-image-1.5и серииnano-banana. Модельdall-e-2— единственная, нативно поддерживающаяn > 1;dall-e-3поддерживает толькоn = 1.
gpt-image-2.
Сценарий 1: Кинематографичный портрет
В подсказках можно использовать кинотермины (35mm пленка, малая глубина резкости, неоновый свет и т.п.) для точного управления атмосферой и текстурой. Пример вызова на Python:
Сценарий 2: Винтажный туристический постер (с рендерингом текста)
gpt-image-2 стабильно работает с типографикой и шрифтами, идеально подходит для создания постеров, меню, открыток с текстом.
url:

AMALFI и ITALIA 1958 четко и корректно отрисованы.
Сценарий 3: Сложная композиция и подсчет
Подсказка проверяет способность модели следовать структурированным инструкциям о количестве и расположении объектов.
dall-e-3.
Сценарий 4: Иллюстративный стиль (горизонтальный формат)
Указание художественных материалов и настроения помогает получить стилизованные иллюстрации.
Асинхронность и обратные вызовы
Вызовgpt-image-2 обычно занимает 60–90 секунд. Если не хочется держать открытым соединение, можно использовать механизм асинхронного обратного вызова через callback_url, процесс вызова идентичен другим моделям.
Серия моделей Nano Banana
Серияnano-banana основана на модели Gemini и подключена через тот же интерфейс /openai/images/generations. Для использования достаточно указать в поле model любое из значений из таблицы ниже.
| Модель | Стоимость (кредиты за вызов) | Сценарии использования |
|---|---|---|
nano-banana | 0.14 | Обычная генерация изображений, самая быстрая и дешевая |
nano-banana-2 | 0.28 | Значительно улучшенное качество и детализация |
nano-banana-pro | 0.35 | Флагман серии, лучшая композиция, детали и рендеринг текста |
Важно: поддерживаемые параметры Nano Banana адаптирован под протокол OpenAI и поддерживает только параметры:model,prompt,size.
sizeмаппится на внутреннийaspect_ratioпо таблице; неуказанные размеры по умолчанию1:1:
1024x1024/512x512/256x256→1:11792x1024→16:91024x1792→9:16- Не поддерживаются параметры
n,quality,style,response_format,background,output_format— они игнорируются.- Возвращаемая структура соответствует формату OpenAI (
data[].url), но полеcreatedвсегда0,b64_jsonне возвращается,revised_promptвсегда совпадает с исходнымprompt.
Базовый вызов
url:

Обновление до флагманской модели nano-banana-pro
Достаточно изменить model на nano-banana-pro, остальные параметры остаются без изменений:

Асинхронный обратный вызов
Механизмcallback_url работает и с nano-banana, процесс вызова идентичен другим моделям, см. раздел Асинхронный обратный вызов.
Базовое использование
Далее можно заполнить соответствующие поля в интерфейсе, как показано на скриншоте:
authorization — выбирается из выпадающего списка, model — выбирается модель OpenAI DALL-E, подробности о моделях приведены выше, и prompt — текст подсказки для генерации изображения.
Справа отображается сгенерированный код вызова, который можно скопировать и запустить, либо нажать кнопку «Try» для теста.

created— ID задачи генерации изображения, уникальный идентификатор.data— содержит информацию о сгенерированном изображении.
data находится конкретная информация о сгенерированном изображении, поле url содержит ссылку на изображение.

Параметр качества изображения quality
Далее рассмотрим, как задать параметры качества изображения. Параметр quality имеет два значения: standard — стандартное качество, и hd — более детализированное и согласованное изображение.
Пример установки параметра качества в standard:


standard:

quality в hd, получаем изображение с более детализированными и согласованными деталями:

Параметр размера изображения size
Также можно задать размер генерируемого изображения.
Пример установки размера 1024x1024:


1024x1024:

1792x1024 даёт изображение с другим соотношением:
Можно задавать и другие размеры, подробности см. в документации на сайте.
Параметр стиля изображения style
Параметр style имеет два значения: vivid — более яркое и живое изображение, и natural — более естественное.
Пример установки style в vivid:


vivid:

natural даёт более естественное изображение:

vivid даёт более живую и насыщенную картинку по сравнению с natural.
Параметр формата ссылки на изображение response_format
Параметр response_format имеет два варианта: b64_json — ссылка на изображение в Base64-кодировке, и url — обычная ссылка на изображение.
Пример установки response_format в url:


url доступна для прямого просмотра: ссылка на изображение

response_format в b64_json возвращается Base64-кодированное изображение:
Асинхронный обратный вызов
Поскольку генерация изображений через OpenAI Images Generations API может занимать продолжительное время, при длительном отсутствии ответа HTTP-соединение остается открытым, что увеличивает нагрузку на систему. Поэтому API поддерживает асинхронный обратный вызов. Схема работы: клиент при запросе указывает полеcallback_url. API сразу возвращает ответ с полем task_id — идентификатором задачи. По завершении генерации результат отправляется POST-запросом в формате JSON на указанный callback_url, включая task_id для связывания результата с задачей.
Пример настройки:
Webhook — это HTTP-сервис, принимающий запросы. Для демонстрации можно использовать публичный сервис https://webhook.site/, где после открытия сайта вы получите уникальный URL Webhook, например:
Скопируйте URL, например https://webhook.site/3d32690d-6780-4187-a65c-870061e8c8ab.
Далее укажите callback_url в запросе:
task_id и поле data с результатом, что позволяет связать ответ с запросом.
Обработка ошибок
При ошибках API возвращает соответствующий код и сообщение. Например:400 token_mismatched: неверный запрос, возможно, отсутствуют или некорректны параметры.400 api_not_implemented: неверный запрос, возможно, отсутствуют или некорректны параметры.401 invalid_token: неавторизован, неверный или отсутствующий токен.429 too_many_requests: превышен лимит запросов.500 api_error: внутренняя ошибка сервера.

