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

Большинство быстрых и дешёвых моделей текст-в-изображение заставляют вас выбирать: либо текст на изображении чёткий и читаемый, либо низкая цена. flux-2-klein-9b/text-to-image — одна из немногих моделей в категории «дёшево и быстро», которая не вынуждает вас выбирать одно из двух. hiapi помечает её тегами Text Rendering, High Fidelity (рендеринг текста, высокая точность) — и на практике это означает, что она может отрисовать за одну генерацию и брендовый текстовый логотип, и строку мелкого текста, и крупный промо-заголовок, без необходимости запускать второй проход для исправления искажённых букв.

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

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

Цены: flux-2-klein-9b против flux-2-klein-4b (текст-в-изображение)

Обе модели относятся к семейству «Klein» и обе ориентированы на скорость и низкую стоимость. Разница в том, за что вы платите:

Модель	Цена за изображение	Теги
flux-2-klein-9b/text-to-image	Фиксированная $0.00858	Text-to-Image, Text Rendering, High Fidelity
flux-2-klein-4b/text-to-image	Фиксированная $0.00143	Text-to-Image, Fast, Cost Efficient

(Цены по состоянию на 2026-08, сверены с /api/pricing.)

flux-2-klein-4b/text-to-image примерно в 6 раз дешевле — подходит в качестве выбора по умолчанию для фоновых подложек, сцен из жизни или любых изображений, где текст не участвует в композиции. Но у неё нет тега рендеринга текста, поэтому если текст на карточке, этикетке или баннере должен быть действительно чётким и читаемым, klein-9b — более надёжный выбор, даже по более высокой цене. А при цене менее одного цента за изображение «надёжность» здесь всё равно дешевле, чем один вызов API большинства LLM.

Реальный запрос

Ниже — рабочий запрос к эндпоинту /v1/tasks для генерации промо-карточки с отрисованным текстом:

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-2-klein-9b/text-to-image",
    "input": {
      "prompt": "Рекламный баннер для соцсетей с ограниченным по времени предложением в электронной коммерции: флакон с пипеткой из матового стекла, на этикетке надпись 'VELURA HYDRA SERUM', по центру на мягком градиентном фоне от румяно-розового к кремовому, сверху крупный жирный аккуратный заголовок без засечек с текстом 'FLASH SALE', тёмно-угольные буквы, ниже строка более мелкого текста '30% OFF' тем же шрифтом, в правом нижнем углу тонкий скруглённый прямоугольный значок с текстом 'VELURA', чёткая читаемая типографика, сбалансированное белое пространство, современный минималистичный маркетинговый дизайн, без другого текста, без водяных знаков",
      "aspect_ratio": "1:1"
    }
  }'

Запрос возвращает taskId. Опрашивайте GET /v1/tasks/{taskId}, пока status не станет success, затем скачайте output[0].url — подписанные ссылки истекают, поэтому сразу забирайте байты и сохраняйте их самостоятельно.

Замечания по схеме: что реально работает

Прежде чем строить что-либо на этой модели, стоит знать несколько моментов, основанных на том, что API действительно принимает (а не только на документации):

• resolution отклоняется.В отличие от некоторых других моделей изображений hiapi, отправка поля resolution возвращает 400 (additional properties not allowed). Отправляйте только aspect_ratio.
• aspect_ratio — это фиксированный короткий список: 1:1, 4:3, 3:4, 16:9, 9:16. Нет 4:5 или 21:9 — если вашему макету нужна более высокая вертикальная обрезка, 3:4 — ближайшее поддерживаемое соотношение (его мы использовали для сцены из жизни ниже).
• Сам aspect_ratio необязателен.Если полностью его опустить, изображение всё равно сгенерируется с серверным значением по умолчанию — но в работе с электронной коммерцией вы почти всегда хотите определённый формат (квадрат для постов в ленте, 16:9 для главного баннера), поэтому стоит задавать его явно, а не полагаться на значение по умолчанию.
• Фиксированная цена за изображение, без градаций по разрешению.В отличие от flux-2-klein-4b/image-to-image (пять ценовых уровней по мегапикселям), klein-9b/text-to-image имеет единый фиксированный тариф независимо от соотношения сторон.

Промпт + результат: главное изображение

Промпт (16:9, использован как есть, без изменений после генерации):

Главное изображение товара для электронной коммерции: флакон с пипеткой из матового стекла, наполненный премиальной сывороткой для ухода за кожей, стоит на влажной серой мраморной плите, мягкий дневной свет слева отбрасывает нежное отражение, минималистичный бежевый фон, мелкие капли воды на мраморе, на этикетке флакона чётко написано 'VELURA' чистым современным шрифтом с засечками, ниже более мелкий текст 'HYDRA SERUM', профессиональная студийная съёмка товара, резкий фокус, тонкая контурная подсветка, без другого текста, без рук, без логотипа-водяного знака

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

Промпт + результат: сцена из жизни

Промпт (3:4):

Фотография в стиле лайфстайл для электронной коммерции: флакон с пипеткой из матового стекла с этикеткой 'VELURA HYDRA SERUM', стоит на светлой столешнице в ванной, рядом сложенное белое полотенце и небольшая веточка эвкалипта в горшке, тёплый утренний свет льётся через окно, мягкие тени, малая глубина резкости, естественная непринуждённая композиция, текст на этикетке флакона 'VELURA' и 'HYDRA SERUM' остаётся резким и чётко читаемым, без людей, без рук, без дополнительных текстовых наложений

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

Промпт + результат: карточка ограниченного по времени предложения

Промпт (1:1):

Рекламный баннер для соцсетей с ограниченным по времени предложением в электронной коммерции: флакон с пипеткой из матового стекла с этикеткой 'VELURA HYDRA SERUM', по центру на мягком градиентном фоне от румяно-розового к кремовому, сверху крупный жирный аккуратный заголовок без засечек с текстом 'FLASH SALE', тёмно-угольные буквы, ниже строка более мелкого текста '30% OFF' тем же шрифтом, в правом нижнем углу тонкий скруглённый прямоугольный значок с текстом 'VELURA', чёткая читаемая типографика, сбалансированное белое пространство, современный минималистичный маркетинговый дизайн, без другого текста, без водяных знаков

Именно это изображение по-настоящему проверяет тег модели «Text Rendering, High Fidelity»: две строки крупного заголовка плюс текст небольшого значка, всё за одну генерацию. Каждое слово написано правильно, и межбуквенные интервалы сохранены должным образом — но именно поэтому перед публикацией вам всё равно стоит просмотреть его лично (см. ниже).

Не пропускайте вычитку

Собственные рекомендации hiapi по контенту говорят об этом прямо: рендеринг текста ИИ — это «99%, а не 100%». Даже модель с тегом высокой точности текста иногда может ошибиться в слове, пропустить букву или слить два слова вместе — особенно с мелким текстом на этикетках, чем с крупными заголовками (мелкий текст сложнее). Перед публикацией сгенерированной промо-карточки или этикетки товара:

1. Увеличьте каждую строку отрисованного текста до 100% масштаба и просмотрите её.
2. Проверьте орфографию и интервалы, а не просто «похоже ли это на текст».
3. Если что-то не так, сгенерируйте заново — не правьте пиксели вручную, потому что повторный запуск стоит всего лишь малую долю цента.
4. Для часто меняющегося текста (цены, даты акций) рассмотрите наложение на вашем собственном этапе шаблона, а не «запекание» в каждую генерацию — обновлять дешевле, и это полностью устраняет риск повторных запусков.

Пакетная генерация на Python

Для полного каталога товаров оберните ту же схему запроса в цикл:

import requests
import time

API_KEY = "your-api-key"
BASE = "https://api.hiapi.ai/v1/tasks"

def generate(prompt, aspect_ratio="1:1"):
    resp = requests.post(
        BASE,
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "model": "flux-2-klein-9b/text-to-image",
            "input": {"prompt": prompt, "aspect_ratio": aspect_ratio},
        },
    )
    task_id = resp.json()["data"]["taskId"]

    while True:
        task = requests.get(
            f"{BASE}/{task_id}",
            headers={"Authorization": f"Bearer {API_KEY}"},
        ).json()["data"]
        if task["status"] == "success":
            return task["output"][0]["url"]
        if task["status"] == "fail":
            raise RuntimeError(task["error"])
        time.sleep(5)

prompts = [
    ("Hero shot for product SKU-001, studio lighting, label reads 'BRAND NAME'", "16:9"),
    ("Lifestyle shot for product SKU-001 on a wooden shelf", "3:4"),
    ("Flash sale card for product SKU-001, headline 'LIMITED TIME'", "1:1"),
]

for prompt, ratio in prompts:
    url = generate(prompt, ratio)
    print(url)  # download immediately — the URL expires

При цене $0.00858 за изображение каталог из 50 SKU по 3 изображения на каждый (главное, сцена из жизни, промо) обойдётся примерно в $1.29 — по сравнению с одной фрилансерской фотосессией товара это практически мелочь.

flux-2-klein-9b/text-to-image в сравнении со смежными рабочими процессами

Если вы строите на hiapi более полный конвейер изображений товаров, стоит прочитать несколько смежных материалов:

• Если вам нужно редактировать или менять стиль существующих фотографий товаров, а не генерировать с нуля, см. flux-2-klein-4b для ретуши изображений товаров в электронной коммерции — это другая задача (i2i, а не t2i), созданная для обработки реальных фотографий, а не для генерации новых сцен.
• О схемах промптов, характерных для режима изображение-в-изображение уровня 9b (та же сила рендеринга текста, применённая к редактированию), см. промпты flux-2-klein-9b для изображение-в-изображение.
• Полные параметры, актуальные цены и консоль для тестирования промптов перед пакетным запуском: страница модели flux-2-klein-9b/text-to-image.

FAQ

Поддерживает ли flux-2-klein-9b/text-to-image изображение-в-изображение? Нет — этот конкретный эндпоинт поддерживает только текст-в-изображение. hiapi отдельно предлагает модель flux-2-klein-9b/image-to-image (цена $0.03143/изображение) для редактирования существующих фотографий.

Какие соотношения сторон поддерживаются? Пять: 1:1, 4:3, 3:4, 16:9, 9:16. Нативного 4:5 нет — используйте 3:4 для похожей вертикальной обрезки.

Можно ли задать выходное разрешение? Нет. Отправка поля resolution возвращает 400. Цена и размер вывода фиксированы по соотношению сторон.

Будет ли дешевле использовать flux-2-klein-4b? Да, примерно в 6 раз дешевле за изображение ($0.00143 против $0.00858) — но у klein-4b нет тега рендеринга текста. Используйте его для изображений без текста (чистые сцены из жизни или фоновые изображения), а klein-9b оставьте для любых изображений с этикетками, заголовками или указанием цены.

Сколько времени занимает генерация? Все три изображения в этой статье через процесс опроса /v1/tasks завершились менее чем за две минуты каждое.

Попробуйте

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