HiAPI
Блог

Руководство по использованию

Создание изображений товаров для электронной коммерции с помощью gpt-image-2.5-sunburst/image-to-image в HiAPI API

Референсные изображения, замена фона, жизненные сцены и рабочий запрос в HiAPI

Nov 20, 2026
Минималистичная обложка: мятно-зелёные точки на почти чёрном фоне, сгущающиеся справа, словно полутоновый набор данных, для руководства по изображениям товаров в электронной коммерции.
На этой странице

Почему image-to-image подходит для фотографий товаров в электронной коммерции

Text-to-image хорошо создаёт товары, которых не существует, — а это почти никогда не то, что нужно команде каталога. У вас уже есть сам товар, упаковка, этикетка и цветовая палитра — вам не хватает времени и бюджета, чтобы отснять каждый SKU с каждым фоном и в каждой жизненной сцене.

gpt-image-2.5-sunburst/image-to-image берёт за основу существующую фотографию и применяет к ней инструкции по редактированию. Это меняет структуру затрат на изображения товаров в нескольких конкретных аспектах:

  • Верность настоящему товару. Входное изображение несёт форму, материал, цвет и вёрстку этикетки. Задача модели — сохранить эти признаки, изменяя то, что вы просите изменить, а не придумывать похожий товар заново.
  • Более дешёвые итерации. Смена фона или сцены — это правка промпта, а не бронирование студии. За один день вы можете протестировать несколько направлений жизненных сцен для одного SKU и оставить лучший вариант.
  • Единообразие набора материалов. Поскольку каждое выходное изображение происходит от сопоставимой исходной фотографии, партия правок сохраняет схожесть, чего редко удаётся добиться при генерации с нуля.

Когда использовать — и когда не использовать

Выбирайте image-to-image, когда сам товар фиксирован, а окружение изменяемо: замена фона для карточек товара на торговой площадке, создание жизненных сцен для рекламы и лендингов, сезонная смена оформления или локализация реквизита. Это также разумный инструмент для доработки приемлемой, но не идеальной фотографии.

Не используйте его, когда нужно сгенерировать концепт, которого никогда не существовало; когда исходная фотография непригодна (сильно расфокусирована, товар в основном перекрыт); или когда требуется точное воспроизведение текста этикетки с полиграфической точностью. В этих случаях пересъёмка или векторные материалы превосходят любую модель.

Практический подход: считайте исходную фотографию источником фактов, а промпт — чётко ограниченной инструкцией. Каждая написанная вами инструкция по редактированию должна отвечать на вопрос: «Что я сохраняю, а что меняю?» Если запрос оставляет это неоднозначным, качество рушится.

Вы вызываете тот же эндпоинт, что описан на странице модели; остальная часть этого руководства посвящена тому, как подать ему хорошие данные.

Подготовка референсных изображений, которые переживут редактирование

Модель может сохранить только то, что видит. Большинство разочаровывающих результатов редактирования товаров объясняется входной фотографией, а не промптом. Прежде чем что-либо отправлять, прогоните исходное изображение через короткий контрольный список.

Разрешение и резкость

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

Композиция и свободное пространство

Оставляйте пустое пространство вокруг краёв товара. Если предмет касается рамки, у модели нет места для построения нового фона, и она часто обрезает или искажает объект. Съёмка отдельного предмета с чистыми полями по периметру редактируется гораздо надёжнее, чем плотно обрезанное изображение, и даёт вам пространство для перекомпоновки в новой сцене.

Отделение объекта

Пиксельно идеальная обтравка не нужна, но чистое разделение товара и фона делает большую часть работы. Достаточно однородного фона с малым количеством деталей (бесшовная бумага, нейтральный градиент, однотонная стена). Захламлённый фон конкурирует с вашими инструкциями и просачивается в результат.

Освещение и ракурс

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

Этикетки, логотипы и текст

Если на товаре есть текст, который покупатель должен прочитать, убедитесь, что на исходном изображении он чётко читается. Модель старается его сохранить, но мелкий или наклонный текст деградирует первым. Для регулируемых или критичных для бренда надписей планируйте этап ручной проверки и по возможности направляйте сторону с текстом к камере.

Несколько слов о пакетной обработке

При подготовке нескольких SKU стандартизируйте их: одинаковое соотношение кадрирования, одинаковые поля, одинаковая тональность фона. Усилия, вложенные на этом этапе, напрямую отражаются в согласованности результатов и позволяют безопасно переиспользовать промпты для всей категории.

Чистая замена фона товара

Замена фона — самая распространённая правка в электронной коммерции и место, где чаще всего ленятся писать промпт. «Новый фон» — это не инструкция, а пожелание. Модели нужно знать, как выглядит новое пространство и как товар должен в него вписываться.

Описывайте пространство, а не просто слово

Укажите поверхность, фон и свет. «Товар на матовой белой поверхности с мягким градиентным фоном, крупный рассеянный основной свет сверху слева, мягкая контактная тень под товаром» даёт модели сцену для построения. «Белый фон» оставляет ей простор для догадок.

Явно указывайте условия сохранения товара

Каждый промпт для фона должен содержать условие сохранения: сохранить форму, пропорции, цвет, материал и текст этикетки товара без изменений. Это почти ничего не стоит при написании, но заметно снижает дрейф, особенно у предметов с характерным силуэтом.

Защищайте края и тени

Чистая обтравка получается из промптов, где упоминаются контакт и затенение. Требуйте естественную контактную тень в месте соприкосновения товара с поверхностью и резкие края на новом фоне. Если вы меняете тёмный фон на светлый, рассчитывайте, что модели потребуется помощь с контровым светом, — укажите, что освещение краёв товара соответствует новой обстановке.

Согласовывайте свет с самим товаром

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

Ограничения площадок

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

Меняйте по одной переменной за итерацию

Сначала замените фон, убедитесь, что товар сохранён, затем настраивайте тени или освещение. Меняя в одном промпте несколько вещей, вы не поймёте, какая инструкция вызвала сбой, а каждый неудачный запрос по-прежнему расходует вашу квоту на выходные изображения.

Помещение товара в жизненные сцены

Именно в жизненных сценах image-to-image раскрывает ценность: товар остаётся узнаваемым, а окружающий мир меняется. Здесь важны пропорции, освещение и правдоподобие.

Привязывайте сцену несколькими конкретными деталями

Промпту сцены нужно достаточно конкретики, чтобы ограничить композицию, но не нужно прописывать каждый пиксель. Укажите обстановку, поверхность, на которой стоит товар, одну-две вспомогательные детали реквизита и характер света. «На столешнице из состаренного дуба на кухне, утренний свет из окна справа, размытые керамическая кружка и сложенная льняная ткань на фоне» — рабочий вариант. Длинный перечень реквизита — нет: он конкурирует с товаром за внимание модели.

Правильно задавайте пропорции

Указывайте реальные размерные соотношения товара, потому что у модели нет линейки. Высокая бутылка и маленький бальзам для губ по отдельности выглядят правдоподобно, а вместе — абсурдно. Упоминание поверхности и узнаваемого ориентира (рука, стандартная кружка, полка) даёт пропорциям опору.

Сначала согласуйте свет исходника, затем сцену

Вы решаете две задачи освещения одновременно: существующую светотень товара и освещение новой обстановки. Если исходный свет рассеянный и равномерный, выбирайте сцену с мягким дневным светом, а не с ярким контровым закатом. Явно задайте направление света и укажите, что освещение товара должно соответствовать сцене. При конфликте вы либо получите переосвещённый товар, переставший соответствовать другим снимкам, либо эффект наклейки.

Товар в резкости, сцена второстепенна

Укажите, что товар — чёткий главный объект, а окружение слегка не в фокусе. Эта одна инструкция повышает реалистичность сильнее любого перечня реквизита и не даёт модели придумывать броские детали на фоне.

Меняйте сцены, а не товар

Для страниц категорий держите шаблон сцены неизменным и меняйте только один элемент между разными SKU — сезон, поверхность, реквизит. Общий сценарий сцены заставляет набор изображений жизненных сцен читаться как одна кампания, а не как коллаж из стоковых фотографий.

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

Рабочий запрос image-to-image в HiAPI

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

Запрос

curl -X POST "https://api.hiapi.ai/v1/images/edits" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-sunburst/image-to-image",
    "image": "https://your-cdn.example.com/products/sku-1042-source.jpg",
    "prompt": "Сохраните форму, пропорции, цвет, материал и текст этикетки товара без изменений. Замените фон на матовую тёпло-серую поверхность с мягким градиентным фоном, крупным рассеянным основным светом сверху слева, естественной контактной тенью под товаром, резкими краями товара; товар остаётся чётким главным объектом.",
    "size": "1024x1024",
    "n": 1
  }'

Поле image принимает размещённый URL или, если ваши материалы недоступны публично, полезную нагрузку в base64 — base64 позволяет непубличным SKU не попадать в публичный CDN. Во время итераций держите n равным 1; несколько кандидатов умножают затраты и затрудняют привязку изменений качества к конкретной правке промпта.

Разбор ответа

API возвращает JSON-тело с массивом data; каждый элемент содержит итоговое изображение (base64 или URL в зависимости от настроек вашей учётной записи). Проверьте метку времени создания в ответе и любые поля использования в ответе и запишите их вместе с ID запроса для последующей сверки.

Минимальный вызов на Python выглядит так:

import os, requests

resp = requests.post(
    "https://api.hiapi.ai/v1/images/edits",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "gpt-image-2.5-sunburst/image-to-image",
        "image": source_url,
        "prompt": prompt,
        "size": "1024x1024",
        "n": 1,
    },
    timeout=180,
)
resp.raise_for_status()
item = resp.json()["data"][0]

Практические замечания по интеграции

  • Храните промпт вместе с каждым результатом. Через несколько недель воспроизвести победившее изображение можно только при наличии точного промпта и исходного изображения.
  • Разделяйте сбои передачи и сбои модели. Таймауты и ответы 5xx можно повторять; запросы, отклонённые из-за неподдерживаемого размера, повторять нельзя.
  • Скачивайте и сохраняйте результаты сразу, а не полагайтесь на временные URL.
  • Держите строку модели в конфигурации, а не разбросанной по коду, чтобы будущая замена модели требовала изменения одной строки.

Справочник по эндпоинту и поддерживаемым параметрам см. на странице модели; тарификация там основана на выходных данных, поэтому сокращение неудачных итераций — главный рычаг контроля затрат.

Два входа — точечная матрица исходного изображения и траектория промпта — проходят через один канал API и разрешаются в уточнённую выходную точечную матрицу.

Устранение дефектов и обеспечение согласованности результатов

Даже при хороших входных данных и продуманном промпте редактирование товаров сбоит узнаваемыми способами. У каждого режима отказа есть стандартное исправление.

Дрейф формы товара

Симптом: контур слегка изменился — ручка стала толще, скос выпрямился. Причина: промпт описывает сцену больше, чем товар, и модель переосмыслила объект. Исправление: поставьте условие сохранения в начало, явно назовите форму и упростите описание сцены. Если дрейф сохраняется, композиция исходного изображения, скорее всего, слишком плотная.

Потеря или искажение текста этикетки

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

Несогласованная композиция набора

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

Светящиеся края и «висящий» товар

Симптом: светлый контур вокруг товара или объект без тени, выглядящий как наклейка. Причина: несовпадение освещения исходного изображения и запрошенной сцены. Исправление: явно требуйте естественную контактную тень, указывайте направление света и выбирайте окружение, освещение которого соответствует съёмке исходника.

Пластиковый вид от чрезмерного редактирования

Симптом: текстуры сглажены, ткань слишком чистая. Причина: промпт требует «изысканности» или «профессионализма» без ограничения ретуши. Исправление: требуйте сохранения исходных текстур, зернистости материала и следов износа.

Общее правило

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

Встраивание редактирования изображений в рабочий процесс каталога

Рабочий одиночный запрос — это ещё не конвейер. Чтобы превратить его в производство масштаба каталога, нужна главным образом инженерная дисциплина вокруг вызовов модели.

Стандартизируйте входные данные при приёмке

Создайте небольшой этап предобработки: кадрируйте до стандартного соотношения, добавляйте фиксированные поля и помечайте изображения с низким разрешением или размытостью до того, как они попадут в API. Предварительная проверка, отбраковывающая плохие входные данные, экономит больше затрат, чем любая настройка промптов.

Пакетная обработка по шаблонам, а не по SKU

Разделите товары на категории и дайте каждой категории один-два шаблона промптов. Запустите партию, затем просмотрите сводку миниатюр по шаблону. Изменить шаблон и перезапустить категорию гораздо дешевле, чем писать промпты вручную для каждого элемента, и это сохраняет единый визуальный язык.

Проверка в два этапа

Первый этап — быстрый отсев: похож ли товар на самого себя? Читается ли текст? Чистые ли края? Второй этап — дизайнерская проверка на соответствие бренд-гайдлайнам. Автоматизируйте механические проверки, насколько это возможно, — сравнение хешей изображений с исходником для выявления сильного дрейфа, проверка разрешения и формата для готовых материалов.

Прикладывайте сведения о происхождении

Храните исходное изображение, промпт, ID модели и метку времени вместе с каждым результатом. Когда продакт-менеджер спросит, почему главное изображение выглядит иначе, ответом должно быть сравнение двух записей промптов, а не расследование.

Поэтапное внедрение

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

Знайте, где заканчивается модель

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

Если вы готовы протестировать это на своём каталоге, структура запроса выше — всё, что нужно, чтобы начать работу с gpt-image-2.5-sunburst/image-to-image в HiAPI.

Похожие статьи

Все статьи →

Начните работать с постоянными артефактами ИИ

Получите API-ключ и вызывайте модели изображений, видео и аудио через один API на основе tasks.

Читать документацию API