HiAPI
Блог

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

Flux-2 для генерации изображений товаров в электронной коммерции: рецепты промптов и рабочий запрос HiAPI

Шаблоны промптов для ракурсов, освещения и мелких деталей, плюс копируемый запрос HiAPI и пакетный режим

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

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

У производства товарных изображений есть проблема кривой затрат: каждый SKU требует нескольких ракурсов, согласованного освещения и чистого фона, а предельная стоимость «сделать ещё один вариант» высока как при съёмке, так и при ретуши. Когда у вас есть надёжное описание товара и воспроизводимый промпт, генерация изображений по тексту меняет эту арифметику.

Сценарии, где генерация по тексту выигрывает

  • SKU с длинным хвостом и варианты. Цвета, размеры и конфигурации, ради которых не стоит устраивать отдельную съёмку, всё равно могут получить изображения, готовые к внесению в каталог.
  • Концепт-изображения и заглушки. Страницы категорий, A/B-тесты и списки товаров до запуска нуждаются в правдоподобных изображениях ещё до прибытия физических образцов.
  • Исследование стиля. Можно быстро протестировать фон и направление освещения, зафиксировав визуальное направление до заказа официальной съёмки.

Сценарии, где фотографию не заменить

Если решение покупателя зависит от физических деталей — строчки, износ, сертификационные ярлыки, точный цвет при реальном освещении — сгенерированное изображение является лишь концепцией, а не доказательством. Используйте выход flux-2/text-to-image как материал для каталога только тогда, когда изображение способно представлять товар, который вы фактически отгружаете; для главных изображений, где точность является преимуществом, сохраняйте настоящую фотографию.

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

Фотография, image-to-image и генерация по тексту — три маршрута к одной и той же рамке каталога; прямой путь генерации по тексту достигает её с минимальным числом слоёв.

Базовая структура промпта, стабильно переиспользуемая между SKU

Промпт, который работает для одного товара и ломается на другом, обычно возникает из-за смешения специфичных для товара фактов и решений о сцене. Разделите их.

Каркас из шести слотов

[субъект] — [ракурс] — [освещение] — [фон] — [детали] — [стиль/ограничения]
  • Субъект: что это за объект, материал, цвет и любые определяющие формы. Держите фактическим.
  • Ракурс: положение камеры относительно товара (фронтальный три четверти, сверху, на уровне глаз).
  • Освещение: основной софтбокс, контурный свет, мягкость теней, направление.
  • Фон: поверхность, цвет и в фокусе ли он.
  • Детали: две-три особенности, которые проверяет покупатель.
  • Стиль/ограничения: коммерческая товарная фотография, чёткий фокус, без текста, центрированная композиция.

Заполненный пример

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

Держите слоты стабильными, заменяйте факты

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

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

Рецепты промптов для ракурсов камеры и освещения

Эти шаблоны рассчитаны на вставку после вашего слота [субъект]. Замените цвет фона в соответствии с вашей фирменной основой.

Рецепты ракурсов

Фронтальный три четверти (ракурс главного изображения по умолчанию)

фронтальный ракурс три четверти, камера на средней высоте товара, товар по центру,
виден весь товар, небольшие поля со всех сторон

На уровне глаз / строго спереди

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

Вид сверху в раскладке

вид сверху, камера перпендикулярна поверхности,
товар по центру с равномерными полями, плоская тень под ним

Лёгкий наклон сверху (подходит для товаров в коробках)

вид на товар под углом 30 градусов сверху, видны и передняя, и верхняя сторона,
камера наклонена к центру товара

Рецепты освещения

Мягкий студийный свет (надёжный по умолчанию)

большой софтбокс как основной свет сверху слева, белый отражатель-заполнение справа,
мягкая контактная тень под товаром, без резких бликов

Боковой свет для подчёркивания текстуры

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

Чистый каталог на белом

два мягких источника света под углом 45 градусов дают яркое равномерное освещение, минимум теней,
бесшовный белый фон, чёткое отделение краёв товара

Эмоциональный акцент (близко к лайфстайл-сцене)

одиночный направленный основной свет сверху справа, глубокое затухание к тёмно-серому фону,
мягкий блик на одном крае, контролируемые тени

Общие указания по композиции

  • Указывайте высоту камеры, когда важна перспектива; «средняя высота» и «вид сверху» дают заметно разные силуэты.
  • Указывайте, куда падают тени. Неуказанные тени — самая частая причина несогласованности в партии.
  • Фиксируйте формулировку полей («небольшие поля со всех сторон»), чтобы товар не обрезался по-разному во всей партии.

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

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

Формулировки для повышения следования промпту и высокой детализации

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

Точно называйте материалы

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

Ограничивайте то, что вам важно

Модель лучше следует явным ограничениям, чем подразумеваемым пожеланиям. Формулируйте ограничения как утверждения об изображении:

товар занимает около 70% ширины кадра
область логотипа пустая и без маркировки
текст на ярлыке рендерится как пустая область, без букв
в кадре только один товар, без реквизита

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

Указывайте на детали, а не восхваляйте их

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

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

Управляйте дрейфом через контролируемые слова сцены

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

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

Списки негативных слов для предотвращения типичных провалов товарных изображений

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

Сокращённый стартовый список

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

Почему стоит оставить каждую строку

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

Различайте по категориям

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

Практическое правило

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

Один рабочий запрос flux-2/text-to-image в HiAPI

Запрос ниже отправляет промпт в flux-2/text-to-image через унифицированный интерфейс HiAPI. Замените строку промпта — и у вас есть первое изображение товара.

Запрос

curl -X POST "https://api.hiapi.ai/v1/images/generations" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-2/text-to-image",
    "prompt": "матовая керамическая кофейная кружка тёмно-лесного зелёного цвета, фронтальный ракурс три четверти, камера на средней высоте товара, товар по центру с небольшими полями со всех сторон, большой софтбокс как основной свет сверху слева, белый отражатель-заполнение справа, мягкая контактная тень под товаром, бесшовный светло-серый фон, видимая матовая глазурная текстура и чистая изогнутая ручка, коммерческая товарная фотография, чёткий фокус, без текста, без логотипов",
    "negative_prompt": "текст, водяной знак, логотип, дублированный товар, загромождённый фон, пересвеченные резкие блики на глянце, геометрические искажения, обрезанные края товара",
    "aspect_ratio": "1:1",
    "n": 1
  }'

Объяснение по полям

  • model — сохраняет маршрутизацию вызова к flux-2 text-to-image. Фиксируйте его явно, чтобы будущие изменения значений по умолчанию не изменили незаметно внешний вид вашего каталога.
  • prompt — каркас из шести слотов, описанный выше, собранный из одного рецепта ракурса и одного рецепта освещения.
  • negative_prompt — сокращённый список исключений; обрезайте его по категориям при ревью выходов.
  • aspect_ratio — фиксируйте по каналу (квадрат для плитки сетки, вертикаль для карточек списка на мобильных), чтобы партия оставалась единообразной.
  • n — держите равным 1 при оптимизации промпта, повышайте, когда нужны варианты для выбора.

Чтение ответа

API возвращает JSON-объект с данными сгенерированного изображения и метаданными запроса. Разберите полезную нагрузку изображения, запишите её в хранилище с ключом имени, содержащим SKU и комбинацию ракурса/освещения (например, mug-green__front34__soft-studio), и сохраните точный промпт рядом с файлом. Эта пара «имя файла плюс промпт» делает последующий QA и повторную генерацию выполнимыми. Тарификация следует стандартному учёту генерации изображений платформы; смотрите текущие тарифы на панели цен в аккаунте, а не зашивайте предположения в скрипт.

Пакетная генерация промптов для списков SKU

Когда одиночный запрос работает, пакетная обработка — это подстановка шаблона плюс цикл. Каркас живёт в коде, факты о товаре — в данных.

Шаблон

ANGLES = {
    "front34": "фронтальный ракурс три четверти, камера на средней высоте товара, товар по центру с небольшими полями со всех сторон",
    "flat": "вид сверху, камера перпендикулярна поверхности, товар по центру с равномерными полями, плоская тень под ним",
}
LIGHTING = "большой софтбокс как основной свет сверху слева, белый отражатель-заполнение справа, мягкая контактная тень под товаром"
STYLE = "коммерческая товарная фотография, чёткий фокус, без текста, без логотипов, центрированная композиция"

def build_prompt(sku, angle_key):
    return f"{sku['subject']}, {ANGLES[angle_key]}, {LIGHTING}, {sku['background']}, {sku['detail']}, {STYLE}"

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

Что проверить перед масштабированием

  • Сборка промпта детерминирована. Один и тот же SKU и ракурс всегда должны давать одинаковую строку промпта. Если нужно доказательство, записывайте хеш каждого промпта.
  • Фиксированные значения слотов действительно фиксированы. Фон, освещение и стиль должны приходить из констант, а не из примешанных данных по каждому элементу.
  • Соотношение сторон задаётся по каналу, а не в точке вызова. В одном месте конфигурации, а не разбросано по циклу.
  • Ключи хранения несут ракурс и освещение. Вам понадобится перегенерировать отдельную ячейку позже; сделайте их адресуемыми.
  • Сначала запустите небольшой пилот. Десять SKU со всеми ракурсами для ревью до обработки полного списка.

Ожидания по затратам и времени

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

Ревью выходов перед внесением в каталог

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

Чек-лист

  • Ракурс соответствует метке. Файл с именем front34 должен действительно быть фронтальным ракурсом три четверти. Несовпадение ракурса ломает согласованность сетки, даже если каждое изображение по отдельности выглядит хорошо.
  • Полный товар в кадре. Нет обрезанных краёв, товар не касается границ кадра.
  • Без текста. Любые буквы, водяные знаки или артефакты логотипов означают перегенерацию или откат.
  • Соответствие бренду. Цвет фона, мягкость теней и контраст должны гармонировать с существующим каталогом, а не выбиваться из него.
  • Репрезентативность. Представленный товар должен соответствовать фактической отгрузке: правильный цвет, правильный материал, правильные пропорции.

Перегенерация или откат

Когда сбой внешний и исправим через промпт (неверное направление тени, дрейф фона, лишний реквизит), перегенерируйте. Уточните проблемный слот и перезапустите. Когда сбой фактический — модель выдумала особенности, материал выглядит как неверная отделка, форма товара неверна — откатитесь к фотографии, image-to-image или заглушке. Никакая правка промпта не исправит надёжно несоответствие физическому товару.

Держите ревью дешёвым

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

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

Все статьи →

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

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

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