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

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

seedream-4.5/text-to-image создан именно для такого сценария с нулевым обучением. Дайте ему обычное текстовое описание, и он вернёт фотореалистичное изображение без каких-либо референсных фото — включая точный текст внутри картинки, а это именно то, в чём большинство моделей генерации изображений по-прежнему ошибается. На hiapi он, как и все остальные модели, работает через тот же асинхронный эндпоинт /v1/tasks, по цене $0.045 за изображение, с разрешением 2K или 4K.

Оба примера ниже — реальные вызовы API, показывающие точные промпты и сгенерированные изображения без какой-либо постобработки.

Генерация с нуля в сравнении с редактированием реальных фото

seedream-4.5 выпущен в виде двух моделей с разными задачами:

• seedream-4.5/text-to-image (тема этой статьи) генерирует изображения по описанию без входного фото. Используйте его, когда у товара ещё нет чистого референсного фото, когда нужна сцена или концепция, которой нет в каталоге, или когда результат — это маркетинговый арт, а не фотография конкретного физического товара.
• seedream-4.5/image-to-image редактирует уже имеющиеся реальные фотографии товара, сохраняя их точную форму и брендинг, но изменяя фон или контекст — об этом рабочем процессе читайте в руководстве по e-commerce для image-to-image.

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

Пример 1: студийное фото товара, сгенерированное по тексту

Промпт, отправленный модели:

a minimalist amber glass skincare serum bottle with a brushed silver cap
standing on a polished travertine surface, soft diffused window light
casting a gentle gradient shadow, sage green linen backdrop, one small
dried eucalyptus sprig beside the bottle, e-commerce product photography,
sharp focus, clean composition, no text, no logo, subtle reflection on
the stone surface

Параметры запроса: aspect_ratio: "1:1", resolution: "2K".

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

Пример 2: рекламный макет с реальным чётким заголовком

Рендеринг текста — более сложная половина задачи для этой модели: большинство генераторов изображений выдают нечитаемые символы или текст с ошибками. Два промпта, оба без повторных попыток:

Плоский рекламный баннер:

a flat-lay e-commerce marketing banner for a summer skincare sale, an
arrangement of amber glass bottles and dried botanicals on a warm
terracotta background, bold sans-serif headline text 'SUMMER GLOW SALE'
near the top in cream white lettering, smaller text 'Up to 30% Off'
beneath it in matching cream, clean modern layout with generous negative
space on the right third, professional marketing design, crisp legible
typography, warm cinematic lighting

Параметры запроса: aspect_ratio: "4:3", resolution: "2K".

Вертикальная история:

a vertical social media story graphic for a candle brand product launch,
a single black matte ceramic candle jar centered on a deep charcoal
gradient background, bold white headline text 'NEW ARRIVAL' near the
top, smaller subtext 'Shop the Collection' below the product, minimalist
premium aesthetic, soft rim lighting on the candle jar, generous margin
for mobile screen safe zones

Параметры запроса: aspect_ratio: "9:16", resolution: "2K".

Оба заголовка и оба подзаголовка написаны правильно, с равномерным межбуквенным интервалом и расположены именно там, где требует промпт — с первой генерации, без повторных попыток. Именно эта надёжность делает text-to-image пригодным для промо-материалов с жёсткими сроками: рекламный баннер или история, которые раньше делал дизайнер, теперь можно набросать за один вызов API.

Прямой вызов API

seedream-4.5/text-to-image работает через асинхронный эндпоинт задач hiapi: отправьте задачу, опрашивайте до завершения, затем скачайте результат.

curl:

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-4.5/text-to-image",
    "input": {
      "prompt": "a minimalist amber glass skincare serum bottle on a travertine surface, soft window light, sage linen backdrop, e-commerce product photography, no text",
      "aspect_ratio": "1:1",
      "resolution": "2K"
    }
  }'

В ответ вернётся task_id. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded, затем прочитайте изображение из output[0].url. Этот URL имеет ограничение по времени — скачайте файл сразу.

Python (отправка задачи + опрос + скачивание):

import os
import time
import requests

API_BASE = "https://api.hiapi.ai/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"}


def generate_product_image(prompt: str, aspect_ratio: str = "1:1",
                            resolution: str = "2K") -> bytes:
    resp = requests.post(
        f"{API_BASE}/tasks",
        headers=HEADERS,
        json={
            "model": "seedream-4.5/text-to-image",
            "input": {
                "prompt": prompt,
                "aspect_ratio": aspect_ratio,
                "resolution": resolution,
            },
        },
        timeout=30,
    )
    resp.raise_for_status()
    task_id = resp.json()["task_id"]

    while True:
        poll = requests.get(f"{API_BASE}/tasks/{task_id}", headers=HEADERS, timeout=30)
        poll.raise_for_status()
        data = poll.json()
        if data["status"] == "succeeded":
            image_url = data["output"][0]["url"]
            return requests.get(image_url, timeout=30).content
        if data["status"] == "failed":
            raise RuntimeError(f"task {task_id} failed: {data.get('error')}")
        time.sleep(3)

Пакетная генерация для целой продуктовой линейки

Тот же вызов можно масштабировать на всю продуктовую линейку: список кортежей (name, prompt, aspect_ratio), по одной задаче на элемент, с сохранением на диск под соответствующим именем.

JOBS = [
    {
        "name": "serum-hero",
        "prompt": "a minimalist amber glass skincare serum bottle on a travertine "
                   "surface, soft window light, sage linen backdrop, e-commerce "
                   "product photography, no text",
        "aspect_ratio": "1:1",
    },
    {
        "name": "sale-banner",
        "prompt": "a flat-lay e-commerce marketing banner for a summer skincare "
                   "sale, amber glass bottles on a terracotta background, bold "
                   "headline text 'SUMMER GLOW SALE', smaller text 'Up to 30% Off'",
        "aspect_ratio": "4:3",
    },
    {
        "name": "story-launch",
        "prompt": "a vertical social story graphic, a black matte ceramic candle "
                   "jar on a charcoal gradient background, bold white headline "
                   "'NEW ARRIVAL', subtext 'Shop the Collection'",
        "aspect_ratio": "9:16",
    },
]

for job in JOBS:
    image_bytes = generate_product_image(
        prompt=job["prompt"],
        aspect_ratio=job["aspect_ratio"],
        resolution="2K",
    )
    with open(f"{job['name']}.jpg", "wb") as f:
        f.write(image_bytes)
    print(f"{job['name']}: done")

При цене $0.045 за изображение сезонный запуск из 20 материалов — главных изображений, баннеров и историй вместе — обойдётся примерно в $0.90. Поскольку каждая задача независима, параллельная отправка нескольких вызовов /v1/tasks с параллельным опросом (с соблюдением лимитов вашей учётной записи) быстрее, чем последовательный запуск списка.

Сравнение с seedream-5.0-pro

hiapi также предоставляет seedream-5.0-pro — отдельный, более новый уровень для задач text-to-image в электронной коммерции. Это не одна и та же модель: ценообразование, варианты разрешения и характеристики вывода различаются, а рабочий процесс seedream-5.0-pro описан в его собственном руководстве. Когда результат требует надёжного текста внутри изображения — рекламных баннеров, историй, промо-карточек — и вы хотите фиксированную цену $0.045 за изображение без планирования вокруг тарифов по уровням разрешения, именно seedream-4.5/text-to-image — та модель, которую стоит выбрать.

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

Принимает ли seedream-4.5/text-to-image референсные фотографии? Нет — text-to-image принимает только prompt, aspect_ratio и resolution. Чтобы редактировать существующую фотографию товара, а не генерировать новую, используйте seedream-4.5/image-to-image.

Какие разрешения и пропорции поддерживаются? resolution принимает только 2K или 4K — уровня 1K нет. aspect_ratio принимает 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2 и 21:9.

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

Сколько стоит пакетная генерация продуктовой линейки? $0.045 за изображение независимо от уровня разрешения. Набор из 20 изображений для сезонной кампании стоит около $0.90; набор из 100 изображений — около $4.50.

Можно ли запускать генерацию параллельно, чтобы ускорить пакетные задачи? Да — каждая задача независима, поэтому одновременная отправка нескольких вызовов /v1/tasks с параллельным опросом — самый быстрый способ получить большой объём материалов.

Попробуйте сами

Полный справочник параметров и актуальные цены см. на странице модели и странице цен. Больше шаблонов промптов для этой модели см. в рецептах промптов для seedream-4.5 text-to-image. Если ваш рабочий процесс начинается с реальной фотографии товара, а не с чистого листа, руководство по e-commerce для seedream-4.5 image-to-image описывает способы прямого редактирования.

Получите API-ключ и сгенерируйте своё первое изображение товара или рекламный баннер — код выше можно скопировать и запустить против API hiapi уже сегодня.