Руководство по использованию
Генерация изображений продуктов для электронной коммерции с помощью flux-3 через HiAPI API
Шаблоны промптов, управление фоном и освещением, а также рабочий запрос на генерацию продуктового снимка
На этой странице
Почему flux-3 подходит для продуктовых снимков для электронной коммерции
Конвейеры каталогов товаров проваливаются по скучной причине: согласованность. Страница товара — это не одно главное изображение, а десятки изображений по нескольким SKU, под разными углами и при сезонных обновлениях, и все они должны выглядеть так, будто сняты в один и тот же день в одной и той же студии. Поручать съёмку каждого фотографу медленно и дорого; поручать каждый кадр произвольному генератору изображений обычно даёт набор картинок, каждая из которых по отдельности выглядит правдоподобно, но вместе они смотрятся нелепо.
Именно здесь пригождается flux-3. Это модель генерации изображений, доступная через HiAPI API, а значит ваш продуктовый конвейер может считать создание изображения очередным HTTP-вызовом: отправить промпт вместе с параметрами продукта, получить изображение, сохранить его и перейти к следующему SKU. Без проприетарного SDK, без отдельной регистрации под каждую модель и без связующего кода под каждого провайдера.
Для электронной коммерции особенно важно то, что flux-3 предсказуемо реагирует на структуру промпта. Продуктовый снимок — это крайне ограниченный сценарий: один объект, по центру или намеренно скомпонованный, чистый фон и студийное освещение. Именно эти ограничения вы можете выразить словами, а как только они становятся текстом, они превращаются в переменные шаблона, а не в творческие решения. В этом и разница между «попросить у модели картинку» и наличием шага генерации в рамках задачи по каталогу товаров.
Практический рабочий процесс в этом руководстве такой: определить переиспользуемую структуру промпта, отладить формулировки фона и освещения, пока базовый вариант не будет выглядеть правильно, а затем заменять блок субъекта под каждый продукт. Всё остальное остаётся неизменным — именно это даёт визуальную согласованность в рамках продуктовой линейки.
Что нужно перед началом
- Ключ HiAPI API и актуальный идентификатор модели flux-3, взятый из списка моделей платформы.
- Данные о продукте в структурированном виде: название, материал, цвет, форма и любые заметные детали, которые вы хотите, чтобы модель отрисовала.
- Место для хранения базового промпта и сгенерированных результатов, чтобы позже можно было сравнивать версии.

Из чего состоит промпт продуктового снимка для flux-3
Промпт, который работает только для одного продукта, малополезен. Полезен промпт, который можно заполнить. Добиться этого можно, разбив описание на фиксированные блоки, каждый из которых соответствует переменной в вашем коде.
Пять блоков
- Субъект. Что это за объект, описанный конкретным существительным. «Матовая керамическая кофейная кружка» лучше, чем «красивая кружка». Добавляйте подсказки о масштабе там, где это важно («высокая», «с широким горлом»).
- Материал и поверхность. Отделка и текстура: брашированный алюминий, глазурованная керамика, плетёный хлопок, матовое стекло. Именно отсюда берутся блики модели, поэтому будьте конкретны.
- Фон. Фон и поверхность, на которых находится продукт: бесшовная бумага, камень, мягкий градиент, чисто белый бесшовный фон. Держите этот блок намеренно коротким и скучным — это строительные леса, а не творческий слот.
- Освещение. Направление, качество и контраст: мягкий основной свет слева, большой рассеянный источник, лёгкая подсветка, тонкая тень под объектом. Этот блок определяет большую часть «студийности» и именно его вы будете настраивать чаще всего.
- Кадрирование. Как компонует объектив: центрированный продуктовый снимок, на уровне глаз, ракурс три четверти, плотный кроп, много свободного пространства сверху.
Превращение блоков в шаблон
Эти блоки во время выполнения собираются в одну строку, заменяя для каждого SKU только субъект (и иногда материал):
product photo of {subject}, {material}, {background}, {lighting}, {framing}
Заполненный пример:
product photo of a matte ceramic coffee mug, glazed stoneware with visible clay texture,
on a seamless light gray paper backdrop, soft diffused key light from the upper left
with gentle fill and a soft contact shadow, centered eye-level shot with negative space above
Два правила сохраняют шаблон стабильным. Во-первых, держите порядок блоков фиксированным — перестановка блоков меняет акценты, даже если текст идентичен. Во-вторых, при переходе между SKU держите фиксированные блоки абсолютно идентичными строками, а не переписывайте их каждый раз; незаметный дрейф формулировок — самая частая причина несогласованности фона и освещения в каталоге.
Где не должно быть творчества
Избегайте редакционного языка в фиксированных блоках: никаких эмоциональных прилагательных, никаких стилистических украшений, никаких отсылок к сценам. Оставьте любые вариации для намеренных маркетинговых кампаний, а шаблон каталога держите чистым. Шаблон, который читается как техническая спецификация, выдаёт изображения, которые выглядят как техническая спецификация — именно это и нужно карточке товара.

Управление фоном и освещением
Фон и освещение — это два блока, которые определяют, читается ли набор изображений как цельный каталог. Оба хорошо откликаются на конкретные, физические формулировки.
Фон: стремитесь к скучности
Описывайте фон как физическую декорацию, а не как эстетику. «Бесшовная светло-серая бумага на фоне» и «чисто белый бесконечный фон» надёжны, потому что описывают известную студийную конфигурацию. Слова вроде «минималистичный» или «эстетичный» расплывчаты и часто заставляют элементы сцены просачиваться.
Полезные рычаги:
- Тип поверхности: бесшовная бумага, матовый винил, натуральный камень, светлое дерево.
- Цвет и тон: светло-серый, кремово-белый, тёплый песочный — держите яркость от средней к светлой, чтобы края продукта оставались читаемыми.
- Неразрывность: «бесшовный» или «бесконечный» сообщает модели, что вы хотите слияние фона и пола, устраняя линию горизонта, которую потом трудно убрать.
- Пустота: если ранние попытки добавляют посторонние объекты, стоит явно написать «пустой фон, без реквизита».
Если вам нужен PNG с прозрачным фоном для маркетплейса, сначала генерируйте на чистом однотонном фоне, а затем вырезайте на постобработке. Требовать от модели изображений настоящий альфа-канал — ненадёжный путь.
Освещение: сначала направление, потом качество
Формулировки освещения чётко делятся на два решения. Направление определяет, где лягут блики и тени; качество определяет, насколько мягкими будут края этих бликов.
- Направление: «основной свет сверху слева», «мягкий основной свет спереди», «свет справа с мягкой подсветкой слева». Выберите одно и держите по всей продуктовой линейке.
- Качество: «большой рассеянный источник», «мягкие тени», «равномерное освещение». Для продуктовых снимков рассеянный мягкий свет — безопасное значение по умолчанию, потому что он не пересвечивает глянцевые материалы.
- Контактная тень: «мягкая контактная тень под продуктом» ставит объект на землю; без неё продукт выглядит парящим.
- Контраст: «низкий контраст, ярко и равномерно» подходит для белого фона маркетплейса; чуть больше направленного контраста — для премиальных lifestyle-кропов.
Сохраняйте согласованность продуктовой линейки
Согласованность — это скорее вопрос управления версиями, чем вопрос промпта. Храните блоки фона и освещения как именованные пресеты (например, пресет «белая студия» и пресет «камень») и ссылайтесь на пресет по имени в каждой задаче генерации, а не вставляйте текст под каждый SKU. Когда вы настраиваете пресет, вы настраиваете его один раз, и следующий батч намеренно наследует изменение, а не дрейфует.
Когда результат получается неправильным, меняйте по одному блоку за раз и заново генерируйте тот же продукт. Одновременное изменение фона и освещения не даст вам понять, какая формулировка сработала.

Рабочий запрос к HiAPI для flux-3
Шаг генерации — это один вызов API. Точный путь к эндпоинту, идентификатор модели и поля запроса документированы на платформе, и их следует брать оттуда, поскольку они могут меняться; приведённая ниже форма — это схема, которую нужно встроить в ваш скрипт.
import os
import requests
API_KEY = os.environ["HIAPI_API_KEY"]
presets = {
"white_studio": {
"background": "on a pure white infinity sweep, no props, empty backdrop",
"lighting": "soft diffused key light from the upper left, even fill, "
"soft contact shadow beneath the product, low contrast",
"framing": "centered eye-level product shot, generous negative space",
}
}
def build_prompt(product, preset_name="white_studio"):
p = presets[preset_name]
return (
f"product photo of {product['subject']}, {product['material']}, "
f"{p['background']}, {p['lighting']}, {p['framing']}"
)
def generate(product, preset_name="white_studio"):
payload = {
"model": "flux-3", # confirm the current identifier in the model list
"prompt": build_prompt(product, preset_name),
}
response = requests.post(
"https://api.hiapi.ai/v1/images/generations", # see docs for exact path
headers={
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json",
},
json=payload,
timeout=120,
)
response.raise_for_status()
return response.json()
product = {
"subject": "a matte ceramic coffee mug",
"material": "glazed stoneware with visible clay texture",
}
result = generate(product)
print(result)
Подключение к пакетной обработке
Несколько привычек позволяют безопасно прогонять всё это по каталогу, а не по одному продукту:
- Получайте каждое значение из переменных окружения. Держите ключи подальше от исходного кода и логов.
- Считайте ответ недоверенным. Читайте возвращённую ссылку на изображение или полезную нагрузку из полей документации, затем скачивайте и сохраняйте в собственное хранилище. Не полагайтесь на то, что какой-либо временный URL проживёт дольше задачи.
- Записывайте точную строку промпта вместе с каждым результатом. Храните её рядом с метаданными изображения. Когда позже кто-то спросит, почему изображение SKU 1234 выглядит иначе, ответ должен быть в вашей базе данных, а не в памяти.
- Используйте повторные попытки с экспоненциальной задержкой для временных сбоев и ограничивайте параллелизм, чтобы большие батчи не упирались в лимиты частоты.
- Делайте запросы идемпотентными по SKU и версии промпта, чтобы повторный запуск перезаписывал тот же слот вывода, а не плодил дубликаты.
От шаблона к производственному конвейеру
Первый проверенный промпт — это базовая линия, а не готовый актив. Перевод в производство означает превращение его в нечто, что ваш конвейер может воспроизвести и проверить.
Шаг 1: закрепите базовую линию на небольшой выборке
Сгенерируйте от пяти до десяти продуктов из разных категорий материалов — глянцевый, матовый, тканевый, металлический, прозрачный. Они по-разному проверят блок освещения. Если шаблон выдерживает эту выборку, у вас есть базовая линия; если глянцевый продукт пересвечен или ткань выглядит плоской, настройте этот блок сейчас, а не после прогона каталога.
Шаг 2: назовите пресеты и версионируйте их
Дайте пресету явный идентификатор версии и рассматривайте изменения как новую версию, а не как правку. Простая схема white_studio_v1 → white_studio_v2 позволяет вам заново сгенерировать батч под старым пресетом и сравнить, а также откатиться, если «небольшое улучшение» окажется регрессией для половины ваших SKU.
Шаг 3: храните промпт там, где конвейер может его прочитать
Держите два уровня: общие определения пресетов (фон, освещение, кадрирование, версия) в одном месте, а поля субъекта и материала каждого SKU — в вашей базе данных продуктов. Затем код генерации объединяет их. Это значит, что изменения пресета распространяются на каждую будущую задачу, а данные субъектов остаются в ведении команды каталога.
Шаг 4: сравнивайте результаты систематически
Попарный просмотр перестаёт масштабироваться после нескольких десятков SKU. Более дешёвые сигналы:
- Просмотр контактного листа: соберите батч в одну сетку и просмотрите аномалии. Дрейфующий фон и смещённое кадрирование сразу бросаются в глаза в размере миниатюры.
- Выборка краёв для проверки фона: выбирайте цвет пикселей у границы изображения и помечайте результаты, где углы отличаются от ожидаемого тона пресета. Это ловит самый частый сбой — незаметное изменение цвета фона — без участия человека.
- Проверка положения в кадре: если продукт должен быть по центру и с отрицательным пространством сверху, измеряйте положение массы субъекта на каждом изображении и помечайте аномалии.
Всё помеченное попадает в очередь на проверку; всё остальное публикуется автоматически.
Шаг 5: перегенерируйте осознанно
Как только базовая линия стабильна, новый SKU — это вопрос данных, а не промпта: добавьте поля субъекта и материала, поставьте задачу в очередь, и автоматизация сделает остальное. Оставьте прогоны перегенерации для намеренных изменений — сезонных фонов, новых вариантов освещения — и при этом повышайте версию пресета.
Распространённые ловушки и как их избежать
Большинство сбоев при генерации продуктовых снимков — это одни и те же несколько проблем, и у каждой есть исправление на стороне промпта или на стороне конвейера.
Дрейф фона внутри батча
Самая частая жалоба: изображения выглядят согласованно по отдельности, но различаются между SKU. Почти всегда причина в дрейфе формулировок — кто-то переписал блок фона, или шаблон вставил в него свойства продукта. Исправление: держите фон и освещение как фиксированные строки из единого источника пресетов и в коде проверяйте, что собранный промпт дословно содержит текст пресета.
Посторонний реквизит и элементы сцены
Модели любят добавлять фон: веточку листьев, сложенную ткань, тень, похожую на край стола. Явно заявляйте пустоту («пустой фон, без реквизита») и по возможности держите язык сцены физическим и ограниченным студией. Если это сохраняется, упростите описание субъекта — декоративные прилагательные в блоке субъекта часто притягивают соответствующий декор в сцену.
Парящие продукты
Без контактной тени объект выглядит наклеенным на фон. Включите в блок освещения «мягкую контактную тень под продуктом» и явно указывайте, что продукт лежит на поверхности, а не парит.
Несогласованное кадрирование
Смешение кропов разрушает страницу категории. Зафиксируйте блок кадрирования одной фразой и не давайте ему меняться; если вам нужны разные соотношения сторон, генерируйте одну и ту же композицию и обрезайте на постобработке, а не задавайте промпт под каждое соотношение.
Переусложнённый промпт
Слишком длинные промпты с историей продукта, брендом и описанием часто дают редакционные изображения, а не каталожные. Шаблон должен читаться как раскадровка. Когда результат кажется неправильным, исправление обычно заключается в удалении слов, а не в их добавлении.
Восприятие сбоя генерации как дефекта кода
Один плохой результат — не сигнал переписывать конвейер. Воспроизведите его с сохранённой точной строкой промпта, измените один блок, сгенерируйте заново и только потом делайте выводы. Запись промпта вместе с каждым результатом — именно то, что делает это возможным, и это самая дешёвая привычка, которую стоит завести в первую очередь.
Начните с одного пресета, одного образцового батча и сохранения промпта для каждого изображения; расширяйтесь, как только базовая линия выдержит проверку на всех типах материалов.
Похожие статьи
Все статьи →-
Руководство по использованию
Руководство по началу работы с gpt-6.2-sol: границы возможностей, интеграция через API и тарификация токенов
Ключевые моменты принятия решений и практики интеграции для инженерных команд
-
Руководство по использованию
Руководство по началу работы с gpt-6.2-astra: границы возможностей текстовой модели, ключевые моменты интеграции и контроль затрат
-
Руководство по использованию
Руководство по началу работы с Tripo H3.1: три способа ввода, параметры и как выбрать тариф
Практическое руководство для разработчиков по принятию решений и контролю затрат при интеграции генерации 3D