HiAPI
Блог

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

Генерация изображений товаров для электронной коммерции с помощью seedream-5.0-lite/image-to-image на hiapi

Jul 7, 2026
Генерация изображений товаров для электронной коммерции с помощью seedream-5.0-lite/image-to-image на hiapi

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

Именно здесь пригодится seedream-5.0-lite/image-to-image. Это редактор изображений на основе инструкций от ByteDance: вы предоставляете реальное фото товара (или до 14 референсных изображений), описываете правку естественным языком — и модель следует инструкции, сохраняя неизменённые области согласованными. На hiapi изображение в разрешении 2K стоит всего $0.035 — полный набор из шести изображений для карточки товара обойдётся примерно в $0.21.

Всё ниже сгенерировано реальными вызовами API на hiapi. Каждый раздел показывает фактический результат и точный промпт.

Рабочий процесс: один якорь, множество правок

Паттерн, который делает AI-изображения товаров пригодными для продакшена, — это заякорить и редактировать:

  1. Заякорить — получить чистое, эталонное изображение товара. Сфотографируйте реальный товар или сгенерируйте концепт один раз с помощью seedream-5.0-lite/text-to-image (тоже $0.035).
  2. Редактировать — подайте это якорное изображение в image-to-image, чтобы получить каждую производную версию: замену фона, исправление деталей, цветовые варианты. Идентичность товара берётся из пикселей референса, а не из промпта, поэтому на каждом изображении будет одна и та же сумка.

Вот наше якорное изображение — брезентовая сумка для выходных, сгенерированная один раз моделью t2i и использованная как референс для всех последующих правок:

Структура запроса

seedream-5.0-lite/image-to-image работает на асинхронной конечной точке задач hiapi: отправка на POST /v1/tasks, опрос ID задачи до завершения, затем скачивание URL результата. Четыре входных поля, все обязательные:

Поле Тип Описание
prompt string Инструкция по редактированию
image_urls array 1–14 общедоступных URL референсных изображений
aspect_ratio enum 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
resolution enum Только 2K или 4K — у модели нет уровня 1K
curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-lite/image-to-image",
    "input": {
      "prompt": "Replace the white studio background: place the bag on a weathered wooden bench in a sunlit modern loft. Keep the bag itself completely unchanged.",
      "image_urls": ["https://your-cdn.com/products/weekender-anchor.jpg"],
      "aspect_ratio": "3:2",
      "resolution": "2K"
    }
  }'

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

Паттерн редактирования 1: перестановка фона (карточка → лайфстайл)

Самая частая правка в электронной коммерции: тот же товар, новая сцена. Ключевой приём в промпте — потратить большую часть текста на то, что нельзя менять, а затем описать новое окружение:

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

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

Паттерн редактирования 2: точное исправление деталей (замена фурнитуры)

Ярлык «точное редактирование» у Seedream Lite означает хирургические изменения. Предположим, поставщик сменил латунную фурнитуру на матово-чёрную, а переснимать не хочется. Требуйте только одного изменения и заморозьте всё остальное:

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

Молнии, D-образные кольца и пряжки на ремне становятся чёрными; текстура брезента и композиция не затронуты. Такого рода правка, если перегенерировать её через текст-в-изображение, незаметно переделала бы всю сумку.

Паттерн редактирования 3: цветовая серия

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

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

Повторите с «тёмно-синим», «угольным» и «песочно-бежевым» — и вы получите серию изображений для пяти SKU с одной съёмки за $0.175, с идентичной композицией у каждого варианта, что и делает селектор цветов на странице товара визуально согласованным.

Пакетная генерация полного набора изображений для карточки на Python

В продакшене вы не отправляете правки по одной. API задач легко распараллеливается — отправьте все правки сразу, затем опрашивайте. Вот паттерн, который мы использовали (три правки завершились параллельно менее чем за три минуты):

import json, time, requests, concurrent.futures

API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": "Bearer YOUR_HIAPI_KEY", "Content-Type": "application/json"}
ANCHOR = "https://your-cdn.com/products/weekender-anchor.jpg"

EDITS = [
    ("lifestyle", "3:2", "Keep this exact bag unchanged... place it on a weathered wooden bench in a sunlit loft..."),
    ("hardware-black", "1:1", "Change only the metal hardware to matte black. Do not alter anything else."),
    ("colorway-green", "1:1", "Change only the canvas body color to deep forest green, preserving texture and trim."),
]

def run_edit(name, aspect_ratio, prompt):
    task = requests.post(API, headers=HEADERS, json={
        "model": "seedream-5.0-lite/image-to-image",
        "input": {"prompt": prompt, "image_urls": [ANCHOR],
                  "aspect_ratio": aspect_ratio, "resolution": "2K"},
    }).json()
    task_id = task["data"]["taskId"]
    while True:
        d = requests.get(f"{API}/{task_id}", headers=HEADERS).json()["data"]
        if d["status"] == "success":
            img = requests.get(d["output"][0]["url"]).content   # expires — save it now
            open(f"{name}.jpg", "wb").write(img)
            return name, len(img)
        if d["status"] == "fail":
            raise RuntimeError(f"{name}: {d.get('error')}")
        time.sleep(5)

with concurrent.futures.ThreadPoolExecutor(max_workers=3) as ex:
    for name, size in ex.map(lambda e: run_edit(*e), EDITS):
        print(f"{name}: {size} bytes")

Три практических совета после запуска этого кода:

  • image_urls должны быть общедоступны. Сначала загрузите якорное изображение в свой CDN или объектное хранилище; API проверяет до 14 URL за запрос.
  • Сразу сохраняйте результат. output[0].url — ссылка с ограничением по времени. Прежде чем что-либо ещё, скопируйте байты в свой бакет.
  • При необходимости используйте несколько референсов. Передача нескольких референсных изображений (вид спереди/сзади/детали одного товара или товар плюс стилевой референс) даёт больше сигналов идентичности для сложных вещей, таких как ткани с узором.

Стоимость и когда выбирать эту модель

При $0.035 за изображение 2K реалистичный набор на SKU — одно якорное изображение, одна лайфстайл-перестановка фона, одно исправление деталей, три цветовых варианта — всего шесть изображений, стоит $0.21. Актуальные цены по каждому уровню см. на странице цен hiapi.

Если вы выбираете между редакторами: наше сравнение трёх моделей image-to-image прогоняет одинаковые правки через основных конкурентов, а руководство по Nano-Banana для электронной коммерции описывает другой стек заякоривания и перестановки фона. Преимущество Seedream 5.0 Lite в этом рабочем процессе — точность следования инструкциям, вход с 14 слотами для референсных изображений и единая низкая цена, делающая пакетную обработку на SKU копеечной.

Начало работы

Получите API-ключ, загрузите чистое изображение товара и запустите приведённый выше промпт для лайфстайл-перестановки фона на seedream-5.0-lite/image-to-image — первый набор производных изображений вы получите за считанные минуты. Полный справочник по конечной точке задач см. в документации hiapi.

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

Все статьи →

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

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

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