Qwen Image 2.0 Pro для фотосъёмки товаров в электронной коммерции: рабочий процесс через API hiapi

TL;DR

• Что это: реальный производственный процесс для электронной коммерции с использованием qwen-image-2.0-pro через API hiapi — одно главное изображение продукта, один промо-баннер с отрисованным рекламным текстом и одно изображение-сетка вариантов, все созданные с точными промптами и запросами, показанными на этой странице.
• Почему для работы с продуктами выбирают Pro-уровень: более тонкие реалистичные детали, более надёжная отрисовка текста на изображении (настоящий рекламный текст, а не нечитаемые символы) и лучшее семантическое следование подробным промптам — по цене $0.107/изображение, максимум 2048×2048, тогда как базовый уровень qwen-image-2.0 стоит $0.025/изображение (цены).
• Проверенные факты об API: входная схема принимает prompt и строку size ("2048*2048", "2688*1536", "2368*1728", "1728*2368" или "1536*2688") — поля aspect_ratio нет, и поддерживается только генерация из текста (без image_input / i2i).
• Рабочий процесс: параллельно отправьте по одной задаче на каждый материал через /v1/tasks, опрашивайте их по одной до завершения, сразу скачивайте output[0].url (он истекает), затем перед любой сдачей контента перепроверьте отрисованный текст.

Почему для фотосъёмки продуктов выбирают qwen-image-2.0-pro

Для одного товарного листинга обычно нужны три разных материала, и они должны выглядеть так, будто сняты в одну съёмку: чистое главное изображение для страницы листинга, промо-баннер с настоящим рекламным текстом для маркетинговой кампании и изображение-сетка вариантов для страницы каталога с несколькими SKU. Это шире, чем работа с одним главным изображением, и именно здесь Pro-уровень оправдывает свою ценовую надбавку по сравнению с базовой версией qwen-image-2.0:

• Более тонкие реалистичные детали. Стекло, шлифованный металл, камень — такие детали зеркальных бликов при размере миниатюры в каталоге читаются как «настоящая фотография», а не «рендер».
• Более надёжная отрисовка текста. Промо-баннеры и упаковка требуют точного попадания текста в изображение — с правильным написанием и чистым трекингом. Pro-уровень настроен для этого; баннер ниже на этой странице — неотредактированный пример.
• Лучшее семантическое следование. Три промпта на этой странице длинные и конкретные по поверхности, освещению и компоновке — Pro-уровень выполнил все эти требования, включая инструкцию «без текста» на двух из трёх изображений.

Цена этого — стоимость: $0.107/изображение против $0.025 у базового уровня (актуальные проверенные цены, 2026-08). Для одного главного изображения это лишь погрешность округления. Для каталога из нескольких сотен SKU это реальные деньги — как распределить работу между ними, см. в разделе Pro против базового уровня ниже.

Настройка

Вам нужен только ключ API hiapi, больше ничего — SDK не требуется:

export HIAPI_API_KEY="sk-..."

qwen-image-2.0-pro работает через единую конечную точку асинхронных задач: POST https://api.hiapi.ai/v1/tasks немедленно возвращает taskId, после чего вы опрашиваете GET /v1/tasks/{taskId}, пока задача не завершится.

Три материала, которые нужны каждому товарному листингу

1. Главное изображение продукта

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

Studio product photograph of a single amber glass skincare dropper bottle with a blank matte white label, standing centered on a round travertine stone pedestal, seamless warm off-white studio background, soft diffused key light from the upper left, a subtle soft shadow falling to the right, hyper-detailed macro texture on the glass and brushed-metal dropper cap, photorealistic, catalog-ready e-commerce hero shot, no text, no logos, no props

2. Промо-баннер с отрисованным текстом

Именно здесь проявляется отрисовка текста Pro-уровня. Промпт требует разместить две конкретные строки рекламного текста в определённом углу — без заполнителей и без «вставьте свой текст здесь»:

Flat-lay e-commerce promo banner photograph: three amber glass skincare dropper bottles arranged diagonally on a warm terracotta backdrop with dried eucalyptus sprigs, soft overhead studio lighting with gentle shadows, in the upper right corner bold clean white sans-serif text reading SUMMER GLOW SALE, directly beneath it smaller white text reading SAVE 20% TODAY, no other text anywhere, photorealistic commercial photography, sharp focus

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

3. Изображение-сетка вариантов

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

Overhead flat-lay product grid photograph of six amber glass skincare dropper bottles with blank matte white labels, arranged in two neat rows of three on a light grey seamless studio background, even soft diffused lighting with minimal shadows, consistent spacing between bottles, photorealistic catalog variant-grid layout, no text, no logos

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

Входная схема, проверенная по живому API

Схема /v1/tasks для qwen-image-2.0-pro строже, чем кажется — нет aspect_ratio, нет n, и вообще нет поля для ввода изображения:

Поле	Тип	Обязательное	Значения
prompt	string	✅	Описание вашего кадра
size	string	✅	2048*2048, 2688*1536, 2368*1728, 1728*2368, 1536*2688
negative_prompt	string	Опционально	Что нужно исключить
seed	integer	Опционально	Для воспроизводимости
watermark	boolean	Опционально
prompt_extend	boolean	Опционально	Позволить модели расширять короткие промпты

Для всех, кто переносит запросы с других моделей изображений hiapi, стоит отметить два момента: здесь нет параметра aspect_ratio (используйте напрямую size), и эта модель поддерживает только генерацию из текста — нет поля референсного изображения, поэтому вы не можете дать ей фотографию вашего реального продукта и попросить сгенерировать варианты. Управление только через промпт — это всё, что есть. Полную структуру запроса/ответа и примеры ошибок см. в руководстве по API; эта страница посвящена сценариям использования в электронной коммерции.

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

Поскольку /v1/tasks асинхронный, генерация главного изображения, баннера и сетки — это просто три отправки и три опроса — без последовательного ожидания:

import time
import requests

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

def submit(prompt: str, size: str) -> str:
    r = requests.post(API, headers=HEADERS, json={
        "model": "qwen-image-2.0-pro",
        "input": {"prompt": prompt, "size": size},
    }, timeout=60)
    task_id = (r.json().get("data") or {}).get("taskId")
    if not task_id:
        raise RuntimeError(f"submit failed: {r.text}")
    return task_id

def wait(task_id: str, timeout_s: int = 600) -> dict:
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        task = requests.get(f"{API}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
        if task["status"] == "success":
            return task
        if task["status"] == "fail":
            raise RuntimeError(f"task failed: {task.get('error')}")
        time.sleep(5)
    raise TimeoutError(task_id)

jobs = [
    ("hero-packshot", "Studio product photograph of ...", "2048*2048"),
    ("promo-banner",  "Flat-lay e-commerce promo banner ...", "2688*1536"),
    ("variant-grid",  "Overhead flat-lay product grid ...", "2368*1728"),
]

task_ids = {name: submit(prompt, size) for name, prompt, size in jobs}   # fan out
for name, task_id in task_ids.items():                                    # collect
    result = wait(task_id)
    url = result["output"][0]["url"]           # expires — download immediately
    open(f"{name}.png", "wb").write(requests.get(url, timeout=120).content)

В тестах каждый рендер в диапазоне около 2000px занимал примерно минуту; при пиковой нагрузке закладывайте на каждое изображение несколько минут, прежде чем считать это тайм-аутом.

Pro против базового уровня: что использовать

Оба уровня используют одинаковую схему prompt + size, поэтому переключение между ними — это изменение одной строки поля model:

	qwen-image-2.0 (базовый)	qwen-image-2.0-pro
Цена	$0.025/изображение	$0.107/изображение
Максимальный размер	2048×2048	2048×2048
Отрисовка текста	Хорошая	Сильнее — выбор по умолчанию для рекламного текста
Реалистичные детали	Хорошие	Более тонкие — выбор по умолчанию для главных изображений
Лучше всего подходит	Исследование промптов, крупносерийные черновики, внутренние макеты	Финальные главные изображения/баннеры, любой контент с отрисованным текстом

Практичное распределение для реального каталога: набросайте композицию на базовом уровне, где стоимость одной итерации низкая, затем перерендерите отобранных победителей на Pro-уровне для фактически сдаваемых материалов. Рабочий процесс на базовом уровне — тот же API задач, тот же стиль промптов — см. в разделе Генерация изображений продуктов для электронной коммерции с помощью qwen-image-2.0.

Советы по промптам для фотографий продуктов

Что стабильно работало во всех трёх рендерах:

• Указывайте поверхность и освещение, а не только объект. «Травертиновая подставка», «мягкий рассеянный ключевой свет из верхнего левого угла» вносят больший вклад в реалистичность, чем прилагательные вроде «профессиональный» или «высококачественный».
• Указывайте «без текста, без логотипов» на изображениях, где текста быть не должно. Если не указать, промпты фотографий продуктов иногда оставляют случайные следы этикеток; явное негативное ограничение сохраняет изображение продукта чистым.
• Для баннеров пишите точный текст в эквивалентном кавычковом формате. «Жирный чистый белый шрифт без засечек с текстом SUMMER GLOW SALE» отрисовывается точно; более расплывчатое «немного рекламного текста» оставляет формулировку на волю случая.
• Требуйте пустые этикетки на упаковке, а не крошечный текст бренда. Текст на малых поверхностях — самая сложная цель отрисовки для любой модели изображений — вместо этого накладывайте его на постобработке.

FAQ

Могу ли я передать фотографию реального продукта в qwen-image-2.0-pro, чтобы сгенерировать варианты? Нет — эта модель поддерживает только генерацию из текста, и в её схеме нет поля для ввода изображения. Для рабочих процессов с изображение-в-изображение вам понадобится другая модель на hiapi, которая явно поддерживает i2i.

Настолько ли надёжен отрисованный текст, что его можно сдавать без проверки? Нет — он надёжен, но не идеален. Перед публикацией прочитайте его посимвольно в сравнении с промптом и перегенерируйте при редких ошибках. См. примечание под промо-баннером выше.

Какой размер использовать для главного изображения листинга и баннера? Квадрат 2048*2048 покрывает требования к листингам большинства торговых площадок. Для широких промо-баннеров или карусели главных изображений 2688*1536 или 2368*1728 (горизонтальный/вертикальный) ближе к типичным пропорциям веб-баннеров и не требует постобработки при обрезке.

Поддерживает ли Pro-уровень скидки за объём? Нет — цена фиксированная $0.107 за изображение независимо от объёма; рычаг стоимости — в том, сколько изображений вы генерируете, а не в оптовых тарифах.

Итог

Для каталогов электронной коммерции преимущество qwen-image-2.0-pro перед базовым уровнем приходится именно туда, где оно нужно фотосъёмке продуктов: более чистые реалистичные детали для главных изображений, надёжная отрисовка текста для промо-баннеров, всё по-прежнему при умеренной цене $0.107/изображение. Отправляйте через /v1/tasks параллельно запросы на главное изображение, баннер и сетку вариантов, проверяйте посимвольно любой контент с отрисованным текстом перед сдачей и переключайтесь на базовый уровень, когда вы итерируете композицию, а не сдаёте финальные материалы. На странице модели qwen-image-2.0-pro есть актуальные цены и справочник параметров — оттуда можно продолжить.