OpenAI

GPT Image 2.6

gpt-image-2.6-sunburst/image-to-image

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

gpt-image-2.6-flare/image-to-image gpt-image-2.6-flare/text-to-image gpt-image-2.6-sunburst/image-to-image gpt-image-2.6-sunburst/text-to-image

Попробовать gpt-image-2.6-sunburst/image-to-image

Ввод

Вывод

image

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

Цены

GPT Image 2.6: ограниченная по времени скидка 20% 20% OFF · До 2026-11-13 Открыть акцию

gpt-image-2.6-sunburst/image-to-image per image

Характеристики	low	medium	high	xhigh	max
1K	~~$0.023~~ $0.0184	~~$0.041~~ $0.0328	~~$0.049~~ $0.0392	~~$0.087~~ $0.0696	~~$0.195~~ $0.156
2K	~~$0.042~~ $0.0336	~~$0.075~~ $0.060	~~$0.090~~ $0.072	~~$0.160~~ $0.128	~~$0.360~~ $0.288
4K	~~$0.075~~ $0.060	~~$0.133~~ $0.1064	~~$0.160~~ $0.128	~~$0.283~~ $0.2264	~~$0.636~~ $0.5088

Общее описание

gpt-image-2.6-sunburst/image-to-image — это модель для редактирования изображений по исходному изображению: на входе одно или несколько исходных изображений и описание правок, на выходе — изменённое изображение. Её главная особенность — сохранение согласованности деталей при многократном редактировании: при повторной корректировке одного и того же персонажа, продукта или макета детали изображения остаются более стабильными, что подходит для производства визуальных ассетов с последовательными итерациями. Разработчики могут вызывать модель через единый интерфейс HiAPI.ai с оплатой за изображение.

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

Согласованность деталей при многократном редактировании — в режимах качества medium или high персонаж, продукт и детали макета сохраняют согласованность между итерациями редактирования, что удобно для повторной тонкой настройки.
Локальное редактирование с помощью разметки — можно передать прозрачный слой с обводкой или пометками в качестве подсказки для правок; сама разметка в выходном изображении не сохраняется.
Композиция из нескольких источников и широкоформатный вывод — поддерживает передачу до 16 исходных изображений за раз, а также соотношения сторон от 3:1 до 1:3 и разрешения от 1K до 4K.

Возможности

Редактирование на основе исходных изображений: на входе от 1 до 16 исходных изображений в форматах jpeg, png, webp; изображение перерисовывается или изменяется согласно описанию правок длиной до 32000 символов; тип выходного файла не зависит от исходного и может быть сразу приведён к нужному формату поставки.

Два способа позиционирования: маска и разметка: mask_url принимает RGBA PNG того же размера, что и первое исходное изображение, и прозрачные пиксели обозначают область редактирования; markup_url использует прозрачный слой как подсказку-обводку; эти параметры взаимоисключающие.

Раздельное управление качеством и планированием: quality управляет уровнем рендеринга (от low до max), complexity отдельно управляет глубиной планирования; при плотном тексте и сложных макетах можно повысить уровень планирования, не увеличивая при этом стоимость рендеринга.

Выходной формат и обработка фона: можно выбрать вывод в png, jpeg или webp; для jpeg и webp поддерживается уровень сжатия от 0 до 100; прозрачный фон доступен только для png или webp, что подходит для материалов, которые нужно сразу накладывать на страницу или дизайн-макет.

Выбор разрешения и соотношения сторон: выходное разрешение — 1K, 2K или 4K; соотношение сторон может автоматически следовать за исходным изображением или задаваться одним из 16 предустановленных значений от 1:1 до 21:9, что позволяет сразу генерировать изображение под нужный формат размещения.

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

Дизайнерские команды: итерации серий изображений персонажей и продуктов — многократное редактирование существующего изображения с описанием правок для получения серии визуальных ассетов со стабильными деталями, что используется для унификации брендовых материалов и изображений продуктов.
Маркетинговые команды: массовая адаптация материалов кампаний — на основе существующего ключевого визуала выводятся материалы в разных соотношениях сторон и разрешениях для разных форматов размещения, которые сразу используются в рекламе и публикациях в соцсетях.
Разработчики: локальные правки по разметке — загружается слой с обводкой, задающий область изменений, и получается изображение с локальными исправлениями; это встраивается в конвейер производства контента и сокращает ручную доработку.
Фронтенд и построение страниц: генерация прозрачных изображений — на основе референсного изображения выводится png или webp с прозрачным фоном, который сразу используется для элементов страниц и компонентов.

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

Ограничения касаются главным образом уровня качества и формы входных данных: преимущество согласованности деталей между итерациями достигается только при качестве medium или high и не гарантируется при низких уровнях качества; маску и разметку нельзя использовать одновременно, к тому же маска лишь обозначает область редактирования — всё изображение всё равно может быть перерисовано; прозрачный фон требует вывода в png или webp, а параметры сжатия действуют только для jpeg и webp. Если задача в основном состоит в генерации непосредственно по тексту и не требует ограничений по исходному изображению, следует использовать линии генерации изображений из текста того же семейства.

Частые вопросы

Все частые вопросы →

Как рассчитывается стоимость? Взимается ли плата за отклонённый запрос?

Оплата производится за каждое изображение; цена зависит от уровня качества и разрешения — см. таблицу цен на этой странице; Flare и Sunburst стоят одинаково. За каждое референсное изображение при генерации изображения по изображению дополнительно взимается $0.012. GIF тарифицируется отдельно по уровню качества и не зависит от разрешения. Запросы с недопустимыми параметрами или с размером GIF, превышающим лимит, отклоняются на этапе отправки, а предварительно удержанная сумма возвращается полностью — плата не взимается.
Можно ли изменить только часть изображения?

Да, можно использовать ветку «изображение в изображение», выбрав один из двух способов. Первый — mask_url: передайте RGBA PNG того же размера, что и первое исходное изображение; полностью прозрачные пиксели и будут областью, которую нужно изменить. Второй — markup_url: передайте PNG-аннотацию с прозрачностью, указав на ней с помощью обводки или других меток места, которые нужно изменить; сама аннотация не появится в результате. Передавать оба параметра одновременно нельзя. Даже при использовании маски модель всё равно может слегка перерисовать всё изображение.
В чём разница между Flare и Sunburst и что выбрать?

Оба варианта имеют полностью одинаковые параметры, способ использования и цену — разница лишь в расстановке акцентов. Согласно описанию OpenAI, Flare генерирует изображения быстрее, подходит для быстрой итерации и пакетной генерации и является рекомендуемым выбором по умолчанию; Sunburst уделяет больше внимания деталям и при многократном редактировании в качестве medium и выше обеспечивает более стабильное сохранение деталей персонажей, продуктов или макета. Обычно сначала используют Flare; когда одну и ту же картинку нужно многократно дорабатывать и требуется стабильность деталей, переключаются на Sunburst и устанавливают quality на medium или выше.
Можно ли напрямую генерировать GIF-анимацию или SVG-вектор?

Да, на линии «текст-в-изображение» достаточно установить output_format в gif или svg; линия «изображение-в-изображение» поддерживает только png, jpeg, webp. GIF управляется тремя параметрами: frame_size задаёт размер каждого кадра в пикселях (по умолчанию 512x512, ширина и высота также определяют пропорции GIF), frame_count задаёт количество кадров (2–16, по умолчанию 9), frame_duration_ms задаёт длительность каждого кадра (по умолчанию 200 миллисекунд). При генерации GIF параметр aspect_ratio не передаётся или передаётся как auto.

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

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.6-sunburst/image-to-image

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

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

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

Объект бизнес-параметров для gpt-image-2.6-sunburst/image-to-image и маршрута default — см. таблицу параметров ниже.

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

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

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

Уровень качества рендеринга: low, medium, high, xhigh, max; если не указан, используется high.

Варианты:lowmediumhighxhighmax

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

URL маски: RGBA PNG того же размера, что и первое исходное изображение; полностью прозрачные пиксели обозначают область для изменения; всё изображение при этом может быть слегка перерисовано. Нельзя передавать одновременно с markup_url.

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

Режим фона: auto, opaque, transparent; для transparent требуется вывод в png или webp.

Варианты:autoopaquetransparent

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

Уровень планирования, независимый от качества рендеринга: low подходит для локальных, точечных изменений, high — для плотного текста и сложной вёрстки; если не указан, используется high.

Варианты:lowmediumhigh

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

Массив URL исходных изображений: от 1 до 16 общедоступных http(s)-изображений; поддерживаются jpeg, png, webp.

Array [ string ]

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

URL аннотации: прозрачный PNG-слой с пометками (например, обводками), указывающими места для изменения; сама аннотация не появляется в результате. Нельзя передавать одновременно с mask_url.

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

Уровень модерации содержимого: auto или low; если не указан, используется low.

Варианты:autolow

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

Уровень разрешения вывода: 1K, 2K, 4K; если не указан, используется 1K.

Варианты:1K2K4K

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

Соотношение сторон вывода; если не указано, используется auto, то есть пропорции исходного изображения.

Варианты:auto1:13:22:34:33:45:44:5

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

16:99:162:11:221:99:213:11:3

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

Формат вывода: png, jpeg, webp; если не указан, используется png. При передаче output_compression необходимо также указать jpeg или webp.

Варианты:pngjpegwebp

output_compressionintegerНеобязательноmin 0max 100

Уровень сжатия 0–100, только для jpeg или webp; при передаче этого параметра необходимо также задать output_format как jpeg или webp.

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.6-sunburst/image-to-image",
  "input": {
    "prompt": "…",
    "quality": "high",
    "image_urls": "…",
    "resolution": "1K",
    "aspect_ratio": "auto",
    "output_format": "png"
  }
}'

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.6-sunburst/image-to-image",
    input: {
      "prompt": "…",
      "quality": "high",
      "image_urls": "…",
      "resolution": "1K",
      "aspect_ratio": "auto",
      "output_format": "png"
    }
  }),
});
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.6-sunburst/image-to-image",
        "input": {
          "prompt": "…",
          "quality": "high",
          "image_urls": "…",
          "resolution": "1K",
          "aspect_ratio": "auto",
          "output_format": "png"
        }
    },
)
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"
    }
  }
}