HiAPI
Блог

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

Wan 2.7 текст-в-изображение для фотографии товаров в электронной коммерции: 4K-изображения студийного уровня за один вызов API

Проверенный на практике рабочий процесс с использованием wan2.7-image/text-to-image на hiapi для создания главных изображений, сцен, упаковки и 4K-макро — с точными промптами, реальным временем выполнения и единой ценой $0.08

Jul 4, 2026
Wan 2.7 текст-в-изображение для фотографии товаров в электронной коммерции: 4K-изображения студийного уровня за один вызов API

Каждое изображение в этом руководстве было создано с помощью wan2.7-image/text-to-image через API задач hiapi в процессе написания статьи — показанные промпты это именно те, что использовались, а время выполнения отражает реальное астрономическое время этих запусков. Если вы продаёте онлайн и вам нужны изображения для карточек товаров, сцены, макеты упаковки или детализированные изображения с зумом, но без бронирования фотостудии, это тот рабочий процесс, который вам нужен.

Почему Wan 2.7 Image для фотографии товаров

Wan 2.7 Image Pro (ID модели wan2.7-image/text-to-image) — флагманская модель текст-в-изображение от Tongyi Wanxiang. Три особенности делают её особенно подходящей для задач электронной коммерции:

  • Вывод до 4K. Просмотрщики с зумом на торговых площадках и печать по требованию требуют большего разрешения, чем типичное значение по умолчанию 1K. Wan 2.7 нативно поддерживает 4096×4096 — без необходимости апскейлинга.
  • Сильное следование промпту. Изображения товаров композиционны: эта бутылка, на той поверхности, с освещением с этой стороны. В наших запусках описания материалов ("матовое стекло", "брашированный алюминий"), направление света и размещение реквизита срабатывали с первого раза.
  • Единая цена. На hiapi — $0.08 за изображение при любом разрешении — 1K, 2K и 4K стоят одинаково (проверено по актуальной странице цен). Большинство премиальных моделей взимают доплату за 4K, так что если ваш процесс в основном использует 4K, фиксированная ставка — более экономичный выбор. Подробнее в сравнении ниже.

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

Быстрый старт: один POST, один опрос

Wan 2.7 Image работает на API асинхронных задач hiapi. Вы отправляете задачу, опрашиваете её до завершения, затем скачиваете результат. Сначала получите ключ API из руководства по быстрому старту.

Отправка:

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image/text-to-image",
    "input": {
      "prompt": "Studio product photograph of a frosted glass serum bottle with a brushed aluminum dropper cap, standing on a seamless pure white background, soft even lighting from two softboxes, gentle contact shadow under the bottle, crisp edges, high detail, commercial e-commerce listing photography",
      "aspect_ratio": "1:1",
      "resolution": "2K"
    }
  }'

В ответе data.taskId содержит ID задачи. Опрашивайте эндпоинт деталей, пока status не станет success:

import requests, time

API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

def generate(prompt, aspect_ratio="1:1", resolution="2K", timeout=600):
    r = requests.post(API, headers=HEADERS, json={
        "model": "wan2.7-image/text-to-image",
        "input": {"prompt": prompt, "aspect_ratio": aspect_ratio,
                  "resolution": resolution},
    })
    task_id = r.json()["data"]["taskId"]

    deadline = time.time() + timeout
    while time.time() < deadline:
        task = requests.get(f"{API}/{task_id}", headers=HEADERS).json()["data"]
        if task["status"] == "success":
            return requests.get(task["output"][0]["url"]).content
        if task["status"] == "fail":
            raise RuntimeError(task.get("error"))
        time.sleep(5)
    raise TimeoutError(task_id)

png_bytes = generate("...")  # save immediately — see the expiry note below

В наших запусках создание задачи возвращается примерно за 2 секунды, генерация 2K завершается за 60–75 секунд, а 4K-изображения занимают 86 секунд. С учётом накладных расходов на опрос закладывайте около полутора минут на изображение.

Перед интеграцией в продакшен есть два эксплуатационных замечания:

  1. URL выходных данных истекают. output[0].url содержит временную метку expireAt — это временная ссылка, а не ресурс CDN. Скачивайте байты и сохраняйте в собственное хранилище в момент успешного завершения задачи. Если вы когда-либо сталкивались с этой проблемой, мы описали режим отказа в статье почему ваш выходной URL hiapi возвращает 404 и что с этим делать.
  2. Список соотношений сторон строгий. Wan 2.7 Image принимает только 1:1, 16:9, 4:3, 21:9, 3:4, 9:16, 8:1, 1:8. Любое другое соотношение — включая распространённые фотографические пропорции вроде 3:2 и 4:5 — вернёт 400 INVALID_REQUEST с сообщением, перечисляющим допустимый список. Мы реально с этим столкнулись: запрос 1536×1920 (что сводится к 4:5) был отклонён; повторная отправка с 3:4 прошла успешно. Если вам нужен 4:5 для Instagram, генерируйте в 3:4 и обрезайте.

Четыре типа изображений, необходимых для каждой карточки товара

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

1. Главное изображение на белом фоне

Amazon, eBay и большинство торговых площадок требуют чисто белый фон для главного изображения карточки. Ключевые моменты в промпте: явно указать фон ("бесшовный чисто белый фон"), потребовать "мягкую контактную тень", чтобы товар не парил, и описать схему освещения так, как это сделал бы фотограф.

Studio product photograph of a frosted glass serum bottle with a brushed aluminum dropper cap, standing on a seamless pure white background, soft even lighting from two softboxes, gentle contact shadow under the bottle, crisp edges, high detail, commercial e-commerce listing photography

Сгенерировано в 1:1 / 2K, заняло 61 секунду. Рендеринг материалов — матовое стекло, сквозь которое видна пипетка, брашированная металлическая текстура на крышке — вот что даёт "сильное следование промпту".

2. Сценическое изображение

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

A frosted glass serum bottle with a brushed aluminum dropper cap standing on a white marble bathroom counter beside a folded beige linen towel and a sprig of eucalyptus, soft morning window light from the left, shallow depth of field, warm lifestyle product photography for an online store listing

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

3. Изображение упаковки с читаемым брендовым текстом

Рендеринг текста — то, на чём большинство моделей изображений терпят неудачу в работе с товарами. Короткий, явно заданный текст надёжно рендерится на Wan 2.7 — поместите точную строку в кавычки и опишите типографику:

Product packaging shot: a matte sage-green cardboard box with the brand name "VELA" printed in clean white sans-serif capital letters on the front panel, standing next to a matching frosted glass serum bottle, studio lighting on a light gray seamless background, sharp focus, e-commerce product photography

"VELA" отрендерилось слово в слово. Честное предупреждение из наших тестовых запусков: это работает для коротких строк, которые вы явно указали. Когда в ранних черновиках нашего баннерного изображения мы оставляли этикетку на усмотрение модели, она изобрела правдоподобную абракадабру на бутылке ("SERUM SERUE") — поэтому либо указывайте точный текст в кавычках, либо просите "без этикеток, без текста, без логотипов" и добавляйте этикетку на постобработке. Всегда вычитывайте любой текст на сгенерированных изображениях перед публикацией.

4. 4K-макро с детализацией

Изображения с зумом на детали оправдывают премиальное ценообразование. Здесь и играют роль 4K-вывод и единая ставка — те же $0.08 за файл 4096×4096:

Extreme close-up macro photograph of fine water droplets on the frosted glass surface of a cosmetic serum bottle, the brushed aluminum cap edge visible at the top of the frame, crisp micro-detail, controlled studio reflections, luxury skincare advertising detail shot

Файл в полном разрешении — 4096×4096 (оптимизированный JPEG около 1,2 МБ), остаётся чётким в просмотрщике с зумом на торговой площадке без какого-либо апскейлинга.

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

Все цены ниже — актуальные ставки hiapi за изображение на момент написания; проверяйте страницу цен для текущих цифр.

Модель 1K 2K 4K Лучше всего для
wan2.7-image/text-to-image $0.08 $0.08 $0.08 Процессы с преобладанием 4K, композиции с насыщенными промптами
gpt-image-2/text-to-image $0.03 $0.04 $0.06 Высокообъёмные каталоги, где достаточно 1K–2K
nano-banana $0.05 — — Скорость (1–2 секунды на изображение), быстрая итерация
nano-banana-pro $0.17 $0.17 $0.2992 Материалы для премиальных брендов, обильный рендеринг текста

Наше рекомендуемое правило принятия решений: если вашим карточкам нужен 4K, Wan 2.7 — самый дешёвый 4K-вариант в линейке продуктов, а единая ставка делает прогнозирование затрат очень простым. Если достаточно 1K–2K и вы ограничены объёмом, gpt-image-2 — бюджетная рабочая лошадка. Если вам нужно десятки раз итерировать композицию перед финализацией, генерация за 1–2 секунды в nano-banana поддерживает быстрый цикл — затем перерендерите победивший вариант в 4K на Wan 2.7.

Полная карточка товара — главное изображение, сцена, упаковка, макро — стоит $0.32 на Wan 2.7, а при параллельном запуске задач занимает менее пяти минут астрономического времени.

Итог

wan2.7-image/text-to-image даёт командам электронной коммерции фотографию товаров студийного уровня за один вызов асинхронного API: единая цена $0.08 за любое разрешение до 4K, сильное следование композиционным требованиям и надёжный рендеринг короткого текста на упаковке. Учитывайте строгий список соотношений сторон, скачивайте выходные данные до истечения URL и вычитывайте любой сгенерированный текст.

Готовы попробовать на своём каталоге? Получите ключ API, начните со страницы модели Wan 2.7 Image Pro, и быстрый старт асинхронного API отрендерит ваше первое 4K-изображение товара примерно за девяносто секунд.

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

Все статьи →

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

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

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