Recraft V4.1 Flash для карточек товаров в e-commerce: $0.01 за изображение, каталог оптом

TL;DR

• В HiAPI recraft-v4.1-flash/text-to-image стоит всего $0.01 за изображение, поэтому 1,000 изображений для каталога обойдутся в $10.00. Стандартная версия recraft-v4.1/text-to-image стоит $0.05 за изображение и принимает те же параметры (сравнение цен).
• В нашем запуске 4 изображения товаров, отправленные параллельно, были готовы за 21.5 секунды фактического времени, каждая задача (включая скачивание) заняла около 19–20 секунд. Общая стоимость: $0.04.
• При установке background_color в белый сгенерированный фон близок к белому, но не является однородным #FFFFFF. Если маркетплейс требует чисто белый фон, потребуется дополнительный шаг очистки.

Когда для каталога стоит выбирать тариф Flash

Используйте Flash при больших объёмах: каждому SKU нужна одна карточка товара на белом фоне плюс одно-два сюжетных изображения, и вы планируете проверять каждое перед публикацией. При $0.01 за изображение 500 SKU по 3 изображения обойдутся в $15.00. Те же 1,500 изображений на стандартной версии V4.1 стоили бы $75.00.

Flash и стандартная V4.1 принимают одинаковые входные поля, поэтому для повышения отобранных изображений до более дорогого тарифа достаточно изменить model. В этой статье мы не сравниваем качество изображений двух тарифов, так как не запускали их с одинаковыми промптами. Прежде чем окончательно выбирать тариф для продакшн-материалов, проверьте результаты самостоятельно.

Проверенная схема входных данных

Мы проверили схему на работающем API, отправляя намеренно недопустимые значения:

Поле	Тип	Примечание
prompt	string (строка)	Обязательно
image_size	enum (перечисление)	square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
colors	массив {r,g,b}	Управление палитрой. Передача строки возвращает 400 INVALID_REQUEST: colors: got string, want array
background_color	{r,g,b}	Цвет фона

Неизвестные поля отклоняются (additional properties ... not allowed), а также любой image_size вне шести предустановок. Пользовательские размеры в пикселях не поддерживаются. Полученные нами размеры: square_hd 1024×1024, portrait_4_3 896×1216, landscape_4_3 1216×896.

Реальный результат одного пакетного запуска

Все четыре изображения ниже получены из одного параллельного пакета. В подписях указаны размеры; стоимость каждого изображения — $0.01.

Карточка товара на белом фоне

E-commerce product photo of a matte sage-green ceramic coffee mug with a curved handle, centered, front three-quarter view, pure white seamless background, soft even studio lighting, gentle contact shadow, no props, no text

recraft-v4.1-flash/text-to-image, square_hd, 1024×1024, background_color белый, $0.01.

E-commerce product photo of a single white leather low-top sneaker with gum rubber sole, side profile facing left, pure white seamless background, soft even studio lighting, subtle shadow under the sole, no props, no text

recraft-v4.1-flash/text-to-image, square_hd, 1024×1024, background_color белый, $0.01.

Кружка хорошо соответствует промпту: по центру, чистая контактная тень, без посторонних предметов. Кроссовок же показывает, почему всё ещё нужна проверка. Мы просили каучуковую подошву (gum rubber sole), но получили кремовую подошву, к тому же обувь расположена в нижней половине кадра, а не по центру. Без сверки с реальным товаром ни одно из этих изображений нельзя использовать как готовую карточку для настоящего SKU.

Сюжетные изображения

Lifestyle product photo of an amber glass dropper serum bottle with a plain white label, standing on a travertine stone tray beside a eucalyptus sprig, bathroom shelf, soft morning window light, shallow depth of field, premium skincare catalog look

recraft-v4.1-flash/text-to-image, portrait_4_3, 896×1216, $0.01.

Lifestyle product photo of a charcoal canvas rolltop backpack leaning against a wooden bench in a sunlit train station, warm afternoon light, shallow depth of field, travel catalog look, no people, no logos

recraft-v4.1-flash/text-to-image, landscape_4_3, 1216×896, $0.01.

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

Что на самом деле возвращает «белый фон»

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

Изображение	Проба угла / края (RGB)	Ровно 255,255,255	Близко к белому (все каналы ≥ 250)
Кружка	255,255,255 · 255,255,253 · 253,254,252	48.1% пикселей	75.4%
Кроссовок	254,253,253 · 251,250,249 · 255,255,255	58.3% пикселей	79.3%

Фон выглядит белым, но не является идеально ровным #FFFFFF. Маркетплейсам, требующим чисто белого фона для главного изображения, нужен этап постобработки. Можно ограничить близкие к белому пиксели значением 255 или вырезать продукт и поместить его на чистый холст. В руководстве по удалению фона в Recraft описан способ вырезания на том же API.

Скрипт пакетной обработки: параллельная отправка, опрос, скачивание

Это скрипт, который мы запускали, в сокращённом виде. У каждого SKU свой Idempotency-Key, поэтому повторные попытки после сетевого тайм-аута не создадут дублирующие платные задачи. URL-адреса вывода временные: наши URL находятся на temp.hiapi.ai и содержат expireAt, истекающий ровно через 7 дней после создания. Скачивайте каждое изображение как можно скорее после успешного завершения задачи.

import os, time, requests
from concurrent.futures import ThreadPoolExecutor

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}",
           "Content-Type": "application/json"}
WHITE = {"r": 255, "g": 255, "b": 255}
BATCH_ID = "catalog-2026-11-01"  # change per intentional new batch

JOBS = [
    {"sku": "mug-sage", "image_size": "square_hd", "background_color": WHITE,
     "prompt": "E-commerce product photo of a matte sage-green ceramic coffee mug ..."},
    {"sku": "serum-amber", "image_size": "portrait_4_3",
     "prompt": "Lifestyle product photo of an amber glass dropper serum bottle ..."},
    # one dict per SKU / shot
]

def run(job):
    payload = {"model": "recraft-v4.1-flash/text-to-image",
               "input": {k: v for k, v in job.items() if k != "sku"}}
    r = requests.post(BASE, json=payload, timeout=60,
                      headers={**HEADERS, "Idempotency-Key": f"{BATCH_ID}-{job['sku']}"})
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    while True:
        task = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
        if task["status"] in ("success", "fail", "failed"):
            break
        time.sleep(3)
    if task["status"] != "success":
        return job["sku"], task["status"]
    img = requests.get(task["output"][0]["url"], timeout=60).content
    with open(f"{job['sku']}.webp", "wb") as f:  # output was WebP in our run
        f.write(img)
    return job["sku"], "saved"

with ThreadPoolExecutor(max_workers=4) as pool:
    for sku, status in pool.map(run, JOBS):
        print(sku, status)

В нашем запуске по каждой задаче возвращалось следующее (показана только одна):

{
  "taskId": "tk-hiapi-01M6AMTSX0B7Z531QT740DS54P",
  "model": "recraft-v4.1-flash/text-to-image",
  "status": "success",
  "storage": "temp",
  "output": [{"type": "image", "url": "https://temp.hiapi.ai/.../...-0.webp", "expireAt": 1794111048}]
}

Метки времени created и completed для этой задачи различаются на 9 секунд. Оставшееся время на стороне клиента ушло на интервалы опроса и скачивание WebP-файлов размером 0.45–1.26 МБ. Подробности полного процесса запросов и опроса см. в руководстве по API Recraft V4.1 и документации HiAPI.

Бюджет каталога

Изображений на SKU	100 SKU	1,000 SKU
1 (только карточка товара)	$1.00	$10.00
3 (карточка товара + 2 сюжетных изображения)	$3.00	$30.00
3 + 2 перегенерации	$5.00	$50.00

На основе Flash по $0.01 за изображение, в соответствии с ценами HiAPI на 1 ноября 2026 года. Перегенерации оплачиваются так же, как любые другие изображения, поэтому закладывайте часть бюджета на них.

Шаблоны промптов для карточек товара

• Начинайте с типа съёмки (E-commerce product photo of ...), затем материал + цвет + продукт.
• Фиксируйте ракурс камеры (front three-quarter view, side profile facing left).
• Явно указывайте фон и освещение (pure white seamless background, soft even studio lighting) и одновременно передавайте background_color.
• Заканчивайте исключениями: no props, no text.
• Сверяйте специфические детали продукта с реальным предметом. Цвет подошвы кроссовка показывает, что модель может ошибаться в таких деталях.

Часто задаваемые вопросы

Достаточно ли Flash для главных карточек товара? Для простых продуктов вроде кружки результат чистый. Но детали могут искажаться (как подошва кроссовка), а фон не является чисто белым #FFFFFF. Проверяйте каждое изображение и при необходимости очищайте фон, если этого требует маркетплейс.

Можно ли сохранить единые брендовые цвета в одном пакете? Да. Передавайте одинаковый массив colors в каждом запросе. Он направляет палитру, но не является попиксельной точной фиксацией цвета.

Как повысить отобранные изображения до стандартной версии V4.1? Отправьте повторно с тем же телом запроса, установив model в recraft-v4.1/text-to-image, по $0.05 за изображение.

Будут ли сгенерированы мои реальные продукты? Нет. Генерация текста в изображение создаёт продукт, соответствующий вашему описанию. Чтобы показать реальный предмет, используйте сгенерированные сцены как фон или мокап либо перейдите на рабочий процесс «изображение в изображение».

Готовы начать черновик каталога? Откройте страницу модели Recraft V4.1 Flash, сначала попробуйте один промпт для карточки товара, а затем запустите пакетный скрипт для остальных SKU.