HiAPI
Блог

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

Рецепт промптов для генерации изображений продуктов электронной коммерции на flux-2-klein-9b

Готовые к копированию структуры промптов для рендеринга текста и высокодетализированных деталей, а также запросы через hiapi API на curl и Python

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

Почему структура промпта важнее его длины

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

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

Более длинный промпт не повышает точность автоматически. После определённой длины дополнительные прилагательные начинают конкурировать: в одном абзаце есть и «glossy», и «matte», появляются два разных направления света, три допустимых оттенка фона. Модель может только усреднить их, а усреднённый промпт даёт посредственные изображения. Короткий промпт с чётко разделёнными слотами даёт модели ясные и недвусмысленные инструкции.

В этом руководстве повсюду используется формат рецепта из пяти слотов:

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

В каждом разделе ниже приведены готовые к копированию строки для конкретного слота. Вы собираете эти строки вместе, запускаете через flux-2-klein-9b/text-to-image в hiapi API и на каждой итерации корректируете только один слот.

Каркас рецепта: субъект, композиция, свет, текст, негатив

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

Subject: [название продукта], [основной материал], [отделка поверхности], [одна отличительная деталь]
Composition: [тип кадра] of [размещение субъекта], [описание фона], [угол камеры]
Light: [направление] [текстура] light, [описание теней]
Text: the words "[точная формулировка]" in [стиль шрифта], positioned [положение], sized [относительный размер]
Negatives: [артефакт], [артефакт], [артефакт]

Заполненный пример для средства по уходу за кожей:

Subject: amber glass dropper bottle, frosted glass body, matte black cap, a thin label band near the base
Composition: product hero shot, bottle centered on a light stone surface, soft neutral background with slight gradient, eye-level camera angle
Light: large softbox from the upper left, gentle falloff toward the right, soft contact shadow under the bottle
Text: the words "DAILY SERUM" in a clean geometric sans-serif, positioned on the label band, sized to span most of the label width
Negatives: warped lettering, duplicate labels, harsh specular hotspots

Два правила делают этот каркас надёжным. Во-первых, порядок менее важен, чем разделение — эти метки (Subject:, Light:) помогают вам сохранять дисциплину при редактировании, и их можно убрать, когда промпт стабилизируется. Во-вторых, держите в каждом слоте лишь несколько конкретных описательных слов. Если слот требует больше двух строк, вы, скорее всего, описываете два разных изображения.

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

Рецепт для чёткого читаемого текста на изображении

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

Цитируйте один раз и точно

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

Text: the words "AURORA" in a bold condensed sans-serif, centered on the front panel, large enough to dominate the upper third

Явно задавайте иерархию

Когда есть два текстовых элемента, укажите, какой из них главный, а какой второстепенный, и опишите их относительные размеры.

Text: primary line "COLD BREW" in a heavy serif, centered; secondary line "single origin" in a smaller light sans-serif directly beneath it, roughly one quarter the height of the primary line

Привязывайте положение к физическим особенностям

«По центру» — слишком слабо. «По центру на передней этикетке, между верхним краем и кольцом горлышка» даёт модели полезную геометрию.

Text: the words "SPF 30" in a rounded sans-serif, positioned in the lower right corner of the label, small relative to the product

Держите текст коротким

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

Рабочие шаблоны для этикеток электронной коммерции

  • Короткий бренд-идентификатор: the words "NORD" in an uppercase geometric sans-serif, tracking wide, centered on the bottle shoulder
  • Объём или вместимость: the words "250ml" in a small regular sans-serif, bottom edge of the label, right-aligned
  • Категорийное слово: the words "BODY LOTION" in a medium-weight sans-serif, one line, spanning the label width

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

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

Точность возникает из физической конкретики, а не из плотности прилагательных. Три слота играют основную роль: материал, отделка поверхности и кадрирование.

Материал

Назовите вещество и одно-два видимых следствия.

Subject: ceramic mug, thick stoneware body, slight irregularity along the rim, speckled clay visible through the glaze

Сравните это с a beautiful high-quality mug, которое не сообщает модели никакой информации, пригодной для рендеринга.

Отделка поверхности

Отделка поверхности — место, где рендеринг чаще всего ошибается, потому что «блестящий» и «премиальный» не являются исполняемыми инструкциями. Опишите, как свет ведёт себя на поверхности.

Subject: stainless steel thermos, brushed horizontal grain, satin finish that spreads highlights into wide soft bands rather than sharp points
Subject: glass perfume bottle, clear thick-walled glass, polished facets that produce crisp edges and a visible refraction through the body

Кадрирование

Заимствуйте фотографические термины. Это даёт модели согласованную пространственную модель объектива.

  • product hero shot, eye-level, centered, shallow depth of field with the background falling off softly
  • three-quarter angle, slightly above eye level, product occupying the lower two thirds of the frame
  • flat lay, directly overhead, product aligned to the frame edges with even margins

Действительно полезные описатели текстуры

Используйте эти слова только если продукт действительно такой: brushed, frosted, matte, satin, polished, woven, knurled, embossed, anodized. Каждое из них соответствует определённой реакции на свет, и именно поэтому они превосходят общие хвалебные слова.

Полная строка описания субъекта, ориентированная на детали:

Subject: matte ceramic candle jar, unglazed exterior with fine grain, smooth glazed interior lip, thin wooden lid resting slightly ajar

Обратите внимание на отсутствие превосходных степеней. Каждое слово ограничивает геометрию или свет.

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

Веса и короткий негативный список

Подчёркивание и ослабление слов

Когда слот игнорируется, у вас есть два рычага: переместить слово ближе к началу промпта или задать ему вес. Синтаксис весов зависит от инструмента, поэтому, прежде чем полагаться на конкретную нотацию в производственной нагрузке, уточните, что принимает flux-2-klein-9b/text-to-image в hiapi API. На практике переупорядочивание — самое переносимое исправление: слова ближе к началу слота влияют сильнее, чем слова, погребённые в конце.

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

Основывайте негативный список на доказательствах

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

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

Negatives: warped lettering, duplicate text, extra fingers, distorted reflections

Для большинства промптов электронной коммерции это примерно полезный предел. Слишком длинные негативные списки создают две проблемы. Во-первых, они расходуют бюджет промпта, который можно было бы потратить на описание продукта. Во-вторых, такие широкие негативы, как blurry или low quality, могут увести модель от законного мягкого фона и тонких текстур поверхности, которые вы на самом деле хотите.

Добавляйте негативы по категориям артефактов:

  • Ошибки текста: warped lettering, duplicate text, misspelled labels
  • Структурные ошибки: asymmetric bottle, floating product, missing lid
  • Ошибки освещения: harsh specular hotspots, double shadows
  • Ошибки фона: cluttered background, visible seams

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

Запуск в hiapi API: curl и Python

Идентификатор модели — flux-2-klein-9b/text-to-image. Оба клиента отправляют одинаковую форму запроса: идентификатор модели плюс объект параметров, содержащий собранный промпт. Замените API key и base URL на значения из вашей учётной записи hiapi.

curl

curl -X POST "$HIAPI_BASE_URL/v1/images/generations" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-2-klein-9b/text-to-image",
    "prompt": "Subject: amber glass dropper bottle, frosted glass body, matte black cap, thin label band near the base. Composition: product hero shot, bottle centered on a light stone surface, soft neutral gradient background, eye-level camera angle. Light: large softbox from the upper left, gentle falloff toward the right, soft contact shadow. Text: the words \"DAILY SERUM\" in a clean geometric sans-serif, on the label band, spanning most of the label width. Negatives: warped lettering, duplicate labels, harsh specular hotspots."
  }'

Python

import os
import requests

payload = {
    "model": "flux-2-klein-9b/text-to-image",
    "prompt": (
        "Subject: amber glass dropper bottle, frosted glass body, matte black cap, "
        "thin label band near the base. "
        "Composition: product hero shot, bottle centered on a light stone surface, "
        "soft neutral gradient background, eye-level camera angle. "
        "Light: large softbox from the upper left, gentle falloff toward the right, "
        "soft contact shadow. "
        "Text: the words \"DAILY SERUM\" in a clean geometric sans-serif, on the label band, "
        "spanning most of the label width. "
        "Negatives: warped lettering, duplicate labels, harsh specular hotspots."
    ),
}

response = requests.post(
    f"{os.environ['HIAPI_BASE_URL']}/v1/images/generations",
    headers={
        "Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}",
        "Content-Type": "application/json",
    },
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(response.json())

Настройка нагрузки

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

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

Сквозной пример изображения продукта для электронной коммерции

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

Subject: matte kraft paper coffee bag with a flat bottom, folded top with a tin tie, fine paper grain visible, a rectangular label panel on the front
Composition: product hero shot, bag standing slightly right of center on a dark walnut surface, muted warm background, three-quarter angle slightly above eye level
Light: soft window light from the left, gentle gradient across the bag face, long soft shadow falling right
Text: the words "NIGHT ROAST" in a bold condensed serif on the label panel, centered; the words "250g" in a small sans-serif beneath it
Negatives: warped lettering, duplicate text, torn paper edges, harsh specular hotspots

Отправьте его через ту же форму запроса, что показана выше, заменив только строку промпта:

prompt = " ".join([
    "Subject: matte kraft paper coffee bag with a flat bottom, folded top with a tin tie,",
    "fine paper grain visible, a rectangular label panel on the front.",
    "Composition: product hero shot, bag standing slightly right of center on a dark walnut surface,",
    "muted warm background, three-quarter angle slightly above eye level.",
    "Light: soft window light from the left, gentle gradient across the bag face, long soft shadow falling right.",
    "Text: the words \"NIGHT ROAST\" in a bold condensed serif on the label panel, centered;",
    "the words \"250g\" in a small sans-serif beneath it.",
    "Negatives: warped lettering, duplicate text, torn paper edges, harsh specular hotspots.",
])

payload = {"model": "flux-2-klein-9b/text-to-image", "prompt": prompt}

Читайте первый рендер как контрольный список. Читается ли текст чётко и написан ли он правильно? Если нет, сократите формулировку или упростите описание шрифта. Видна ли текстура бумаги? Если пакет выглядит как пластик, усильте слот материала и добавьте описатели отделки поверхности. Согласовано ли направление тени? Если вы видите две тени, слот света конфликтует — удалите один источник света.

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

Итерации: от первого рендера к согласованному набору изображений

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

Замораживайте слоты идентичности

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

Осознанно меняйте композицию

Заранее напишите два-три композиционных строки и повторно используйте их между разными SKU:

  • product hero shot, centered, eye-level, neutral gradient background
  • three-quarter angle from above, product in the lower two thirds, surface visible
  • flat lay, directly overhead, even margins on all sides

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

Заменяйте только слот текста для каждого варианта

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

Отслеживайте изменения как диффы

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

Знайте, когда прекратить настройку

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

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

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

Все статьи →

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

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

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