OpenAI

GPT Image 2.5

gpt-image-2.5-flare

Двухуровневая модель генерации и редактирования изображений от OpenAI: Flare делает ставку на скорость, Sunburst — на точность, охватывая как генерацию по тексту, так и многораундовое редактирование изображений

Маршрут

default pro

gpt-image-2.5-flare gpt-image-2.5-sunburst

Попробовать gpt-image-2.5-flare

Ввод

Работы

Все работы

Вывод

image

Заполните параметры и сгенерируйте — результаты появятся здесь.

Концепт-арт сцены Flare: исследование атмосферы мира

Стиль Концепт-арт · Дизайн окружающей среды · Научная фантастика

Референсные входы

image_urls

Промпт

Кинематографичный концепт-арт окружения: в сумерках огромная заброшенная обсерватория на прибрежном утёсе, широкоформатная композиция 16:9. Передний план: влажный базальтовый уступ, усеянный повреждёнными латунными приборами. Средний план: многоярусное здание из камня и окисленной меди с высокими арочными окнами, изнутри сквозь них льётся тёплый янтарный свет; тонкие тросы и антенны вырисовываются силуэтами на фоне неба. Задний план: медленно движущийся слой тумана над сумрачным морем, вдали одинокая башня-монолит наполовину погружена в воду. Объёмный свет пробивается сквозь дымку, естественное освещение даёт контраст тёплых и холодных оттенков, металл, камень и стекло реагируют физически достоверными материалами. Живописно точный рендеринг, предельно высокая микродетализация, сдержанная палитра бирюзового, сланцево-серого и янтарного. Без текста, без водяных знаков, без элементов интерфейса.

Скопируйте полный промпт и адаптируйте под свою задачу.

Теги

Фотореалистичное качество для товаров e-commerce: схема генерации изображений gpt-image-2.5-flare

Стиль Изображение продукта · электронная коммерция · Студийный свет

Референсные входы

image_urls

Промпт

Студийная предметная съёмка: флакон сыворотки для ухода за кожей из матового стекла с крышкой-дозатором из брашированного металла, стоящий на матовом светло-сером акриловом подиуме. Ракурс на 3/4 спереди, макрообъектив 85 мм, малая глубина резкости, чёткие края этикетки, мягкое размытие фона. Освещение: большой софтбокс слева сверху в качестве основного света, узкий контровой свет вдоль правого края флакона для отделения от фона, а также небольшое мягкое заполняющее освещение от отражения от подиума на нижнюю часть стекла. Блики видимы, но контролируемы, без пересвеченных пятен. Бесшовный светло-тёплый серый фон с мягким градиентом, только короткая контактная тень у основания. Чистая композиция главного изображения для e-commerce, достаточно свободного пространства сверху для текста, повышенный микроконтраст металлических частей, точная полупрозрачная текстура матового стекла, без реквизита, без наложенного текста.

Скопируйте полный промпт и адаптируйте под свою задачу.

Теги

Продуктовая съёмка уровня электронной коммерции: рецепт промпта для gpt-image-2.5-flare

Стиль Изображение продукта · электронная коммерция · Студийный свет

Референсные входы

image_urls

Промпт

Студийная продуктовая съёмка для электронной коммерции: флакон для ухода за кожей из матового стекла с крышкой из шлифованного алюминия, по центру на поверхности тёмно-угольного цвета, фон с мягким градиентным переходом. Камера снимает под углом 45° сверху, ракурс как у 85-мм макрообъектива, глубина резкости малая, но контролируемая, чтобы вся этикетка оставалась чёткой и резкой. Освещение: большой софтбокс слева сверху в качестве основного света, вдоль правого контура флакона прочерчен тонкий контурный свет, отделяющий флакон от фона; фон — тонкий градиент от тёмно-серого к почти чёрному; на плече стекла лишь один сдержанный зеркальный блик, без пересвета. Типографика на этикетке чистая и легко читаемая, без лишнего реквизита, без отражений студийного оборудования, без водяных знаков. Качество коммерческой ретуши: достоверная передача материалов, чёткие и резкие края, сдержанная цветокоррекция, квадратный кадр 1:1, вокруг объекта достаточно свободного негативного пространства.

Скопируйте полный промпт и адаптируйте под свою задачу.

Теги

Цены

gpt-image-2.5-flare per image

Характеристики	Цена за единицу
low	$0.0172
medium	$0.0672
high	$0.1829
xhigh	$0.3572
max	$0.7143
auto	$0.3572

Краткое описание позиционирования

gpt-image-2.5-flare — версия в серии моделей изображений OpenAI gpt-image-2.5, ориентированная на баланс скорости и качества. Она доступна на HiAPI.ai через единый интерфейс и поддерживает как генерацию изображений по тексту, так и редактирование изображений на основе референсов. Подходит для коммерческой визуальной продукции с потребностью в стабильной генерации изображений, массовой генерации контента и процессов доработки изображений. Позволяет выводить изображения в разрешении до 3840px, с прозрачным фоном, в различных соотношениях сторон и форматах.

Ключевые особенности

Приоритет скорости без ущерба качеству — по сравнению с предыдущим поколением GPT-Image-2 качество повышено, а задержка заметно снижена, что подходит для пакетных задач, где важен темп генерации.
Генерация по тексту и редактирование в одном канале — одна и та же модель может создавать изображение с нуля по промпту, а также принимать референсные изображения для редактирования, композитинга и сохранения стиля объекта.
Широкий охват соотношений сторон и разрешений — поддерживаются различные пропорции от 1:1 до 16:9, 9:16 и др. — вплоть до пиксельных размеров до 3840x2160 при прямой генерации.
Контролируемые прозрачность и формат — можно выбрать прозрачный фон и форматы вывода png, jpeg, webp, что сокращает вторичную обработку материалов после генерации.

Описание возможностей

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

Редактирование и сохранение по референсным изображениям — можно передать до 16 референсных изображений для редактирования, композитинга или сохранения объекта и стиля при изменениях, что снижает необходимость повторной настройки параметров.

Выбор уровня качества — доступны уровни качества от low до max и auto; разработчики могут выбирать между скоростью генерации и детализацией в зависимости от сценария.

Контроль разрешения и соотношения сторон — можно указать пропорцию или конкретный пиксельный размер, включая уровни 1024, 1536, 2048, 3840; значение auto означает выбор моделью.

Формат вывода и фон — поддерживаются три формата png, jpeg, webp и настройки фона: авто, прозрачный, непрозрачный — с прямым выводом готовых файлов материалов.

Сценарии применения

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

Ограничения и рекомендации по выбору

Как закрытая модель, она не может быть развёрнута локально или дообучена самостоятельно; вывод зависит от вызовов через API. Генерация в высоком разрешении требует больших вычислительных затрат и времени; плотный мелкий текст и сложные легенды по-прежнему остаются уязвимыми сценариями и требуют проверки человеком. Если задача требует исключительно высокой точности деталей и допустимо более длительное ожидание, лучше подойдёт gpt-image-2.5-sunburst; если же нужна ежедневная пакетная генерация с низкой задержкой, этот канал является выбором по умолчанию. Соблюдение политик использования контента обязательно.

Создать задачу генерации

POST https://api.hiapi.ai/v1/tasks

Заголовки

AuthorizationstringОбязательно

API-ключ аккаунта. Обязателен в каждом запросе. Пример: Bearer YOUR_HIAPI_API_KEY. Получить API-ключ

Content-TypestringНеобязательно

Тело запроса всегда разбирается как JSON; при отправке принимается только application/json (charset опционален) — любое иное значение возвращает 415. Пример: application/json.

Idempotency-KeystringНеобязательно

Ключ идемпотентности, до 255 байт. Повторные запросы с тем же ключом того же аккаунта создают задачу лишь один раз; реплеи возвращают исходный taskId.

Ключ идемпотентности

При сетевых таймаутах или автоповторах клиента один и тот же ключ создаёт задачу только один раз, без двойного списания (область = аккаунт API-ключа). Рекомендуется бизнес-уникальный идентификатор (напр. "order-42"); реплеи возвращают исходный taskId, ключ истекает через 24 часа после первого запроса. Полная матрица сценариев — во введении единого асинхронного API.

Тело запроса

modelstringОбязательно

Текущее фиксированное значение: gpt-image-2.5-flare

routestringНеобязательно

Текущее фиксированное значение: pro

inputobjectОбязательно

Объект бизнес-параметров для gpt-image-2.5-flare и маршрута pro — см. таблицу параметров ниже.

promptstringОбязательноminLength 1maxLength 20000

Опишите содержимое изображения для генерации или укажите изменения, которые нужно внести в референсное изображение. Строка, максимум 20000 символов.

qualitystringНеобязательноПо умолчанию: "medium"

Управляет степенью детализации, скоростью генерации и ценовым уровнем выходного изображения; строка, по умолчанию medium.

Варианты:lowmediumhighxhighmaxauto

backgroundstringНеобязательноПо умолчанию: "auto"

Управляет режимом фона выходного изображения (автоматический, прозрачный или непрозрачный); строка, по умолчанию auto.

Варианты:autotransparentopaque

image_urlsarrayНеобязательноminItems 1maxItems 16

Необязательный массив референсных изображений; после передачи используется для редактирования, композитинга изображений или сохранения субъекта и стиля. Элементы — адреса изображений.

Array [ string ]

aspect_ratiostringНеобязательноПо умолчанию: "1:1"

Управляет соотношением сторон или размером в пикселях выходного изображения; строка, по умолчанию 1:1; при значении auto модель определяет его самостоятельно по запросу.

Варианты:1:13:22:34:33:416:99:16auto

Показать все (10)

1024x10241536x10241024x15361536x11521152x15362048x20482048x11521152x20483840x21602160x3840

output_formatstringНеобязательноПо умолчанию: "webp"

Управляет форматом файла выходного изображения; строка, по умолчанию webp.

Варианты:pngjpegwebp

callbackobjectНеобязательно

Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.

Обратные вызовы (Webhook)

Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.

urlstringОбязательно

Обязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.

whenstringНеобязательноПо умолчанию: "final"

Сейчас поддерживается только final — уведомление и при success, и при fail.

Варианты:final

storagestringНеобязательноПо умолчанию: "temp"

Уровень хранения артефактов: temp (по умолчанию, ~7 дней) или persistent (долгосрочно, оплата по объёму). При нехватке баланса или превышении лимита — тихое понижение до temp; фактический уровень виден в ответе деталей задачи.

Варианты:temppersistent

Примеры запроса

# Отправляет асинхронную задачу; сразу возвращает taskId (не ждёт генерации)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2.5-flare@pro",
  "input": {
    "prompt": "…",
    "quality": "medium",
    "background": "auto",
    "aspect_ratio": "1:1",
    "output_format": "webp"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "gpt-image-2.5-flare@pro",
    input: {
      "prompt": "…",
      "quality": "medium",
      "background": "auto",
      "aspect_ratio": "1:1",
      "output_format": "webp"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "gpt-image-2.5-flare@pro",
        "input": {
          "prompt": "…",
          "quality": "medium",
          "background": "auto",
          "aspect_ratio": "1:1",
          "output_format": "webp"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Получить детали задачи

GET https://api.hiapi.ai/v1/tasks/:id

Поля ответа

taskIdstringОбязательно

Идентификатор задачи, всегда с префиксом tk-hiapi-.

modelstringОбязательно

Полное разрешённое имя модели. Задачи, отправленные с параметром route, возвращают base@route (напр. gpt-image-2/text-to-image@ext); иначе совпадает с переданным именем.

routestringНеобязательно

Присутствует только при явном параметре route; повторяет переданное значение.

statusstringОбязательно

Статус задачи.

Значения статуса

queued В очереди, ещё не начата. handling Обрабатывается. archiving Обработка завершена, готовятся артефакты. success Терминальное: завершено, артефакты доступны (возвращается output). fail Терминальное: ошибка (возвращается error). После отправки следите за status: success и fail — терминальные, остальные нет. Опрашивайте каждые 1–3 с до терминального состояния. При успехе скачайте артефакты из output[].url и перенесите до expireAt; для длительного хранения укажите storage: "persistent" при создании.

creatednumberОбязательно

Время создания задачи (Unix-секунды).

completednumberОбязательно

Unix-секунды терминального состояния; до этого — 0.

outputarrayНеобязательно

Только при status == success. Список артефактов — всегда массив; одна задача может вернуть несколько type сразу (напр. video + first_frame).

Array [ object ]

Элементы массива

urlstringОбязательно

URL артефакта, доступен для скачивания напрямую.

typestringОбязательно

Текущие возможные значения: video, image, audio, first_frame, last_frame, thumbnail; список может расширяться.

expireAtnumberОбязательно

Unix-секунды доступности артефакта; скачайте или перенесите до истечения.

errorobjectНеобязательно

Только при status == fail.

codestringОбязательно

Бизнес-код ошибки.

messagestringОбязательно

Описание ошибки.

Примеры ответа

Успех

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

Обработка (не финальное)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Ошибка

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}