HiAPI
Блог

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

Генерация изображений продуктов для электронной коммерции с помощью flux-3 через HiAPI API

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

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

Почему flux-3 подходит для продуктовых снимков для электронной коммерции

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

Именно здесь пригождается flux-3. Это модель генерации изображений, доступная через HiAPI API, а значит ваш продуктовый конвейер может считать создание изображения очередным HTTP-вызовом: отправить промпт вместе с параметрами продукта, получить изображение, сохранить его и перейти к следующему SKU. Без проприетарного SDK, без отдельной регистрации под каждую модель и без связующего кода под каждого провайдера.

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

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

Что нужно перед началом

  • Ключ HiAPI API и актуальный идентификатор модели flux-3, взятый из списка моделей платформы.
  • Данные о продукте в структурированном виде: название, материал, цвет, форма и любые заметные детали, которые вы хотите, чтобы модель отрисовала.
  • Место для хранения базового промпта и сгенерированных результатов, чтобы позже можно было сравнивать версии.
Один продукт, единообразно отрисованный на девяти контролируемых фонах — это и есть обещание 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. Почти всегда причина в дрейфе формулировок — кто-то переписал блок фона, или шаблон вставил в него свойства продукта. Исправление: держите фон и освещение как фиксированные строки из единого источника пресетов и в коде проверяйте, что собранный промпт дословно содержит текст пресета.

Посторонний реквизит и элементы сцены

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

Парящие продукты

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

Несогласованное кадрирование

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

Переусложнённый промпт

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

Восприятие сбоя генерации как дефекта кода

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

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

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

Все статьи →

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

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

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