Qwen Image 2.0 Pro E-Commerce-Produktfotografie: hiapi API-Workflow

TL;DR

• Was das ist: Ein echter E-Commerce-Produktions-Workflow mit qwen-image-2.0-pro über die hiapi API – ein Hero-Produktbild, ein Promo-Banner mit gerendertem Aktions-Text und ein Varianten-Raster, alles generiert mit den exakten Prompts und Requests, die auf dieser Seite gezeigt werden.
• Warum die Pro-Stufe für Produktarbeit: Feinere fotorealistische Details, zuverlässigeres Text-Rendering im Bild (echter Aktions-Text statt Kauderwelsch) und bessere semantische Befolgung detaillierter Prompts – zum Preis von $0.107/Bild bis 2048×2048, gegenüber $0.025/Bild bei der Basis-Stufe qwen-image-2.0 (Preise).
• Verifizierte API-Fakten: Das Input-Schema akzeptiert prompt und einen size-String ("2048*2048", "2688*1536", "2368*1728", "1728*2368" oder "1536*2688") – kein aspect_ratio-Feld, und ausschließlich Text-zu-Bild (kein image_input / i2i).
• Workflow: Reiche pro Asset einen Task parallel über /v1/tasks ein, poll jeden bis zur Fertigstellung, lade sofort output[0].url herunter (läuft ab) und prüfe den gerenderten Text erneut, bevor irgendetwas ausgeliefert wird.

Warum qwen-image-2.0-pro für Produktfotografie wählen

Ein Produkt-Listing braucht in der Regel drei verschiedene Assets, und sie müssen wie aus einem einzigen Shooting wirken: ein sauberes Hero-Bild für die Listing-Seite, ein Promo-Banner mit echtem Aktions-Text für Kampagnen und ein Varianten-Raster für Multi-SKU-Katalogseiten. Das ist eine breitere Arbeitsfläche als ein einzelnes Hero-Bild, und hier rechtfertigt die Pro-Stufe ihren Preisaufschlag gegenüber der Basisversion qwen-image-2.0:

• Feinere fotorealistische Details. Glas, gebürstetes Metall, Stein – diese Art von Glanzlicht-Details liest sich in Katalog-Thumbnail-Größe als „echtes Foto“ statt als „Rendering“.
• Zuverlässigeres Text-Rendering. Promo-Banner und Verpackungen brauchen exakten Text im Bild, korrekt geschrieben, mit sauberer Laufweite. Die Pro-Stufe ist darauf abgestimmt; das Banner weiter unten auf dieser Seite ist ein unbearbeitetes Beispiel.
• Bessere semantische Befolgung. Die drei Prompts auf dieser Seite sind lang und spezifisch in Bezug auf Oberfläche, Licht und Layout – die Pro-Stufe befolgte alle diese Vorgaben vollständig, einschließlich der Anweisung „kein Text“ bei zwei der Bilder.

Der Preis dafür ist der Preis: $0.107/Bild gegenüber $0.025 bei der Basis-Stufe (live verifizierte Preise, 2026-08). Für ein einzelnes Hero-Bild ist das ein Rundungsfehler. Für einen Katalog mit mehreren hundert SKUs ist das echtes Geld – wie man die Arbeit zwischen beiden aufteilt, siehe Pro vs. Basis-Stufe weiter unten.

Einrichtung

Du brauchst nur einen hiapi API-Key, sonst nichts – kein SDK erforderlich:

export HIAPI_API_KEY="sk-..."

qwen-image-2.0-pro läuft über den einheitlichen asynchronen Task-Endpunkt: POST https://api.hiapi.ai/v1/tasks gibt sofort eine taskId zurück, danach pollst du GET /v1/tasks/{taskId}, bis der Task abgeschlossen ist.

Die drei Assets, die jedes Produkt-Listing braucht

1. Hero-Produktbild

Das Bild für die Listing-Seite: ein einzelnes Produkt, zentriert, sauberer Hintergrund, nichts, was um Aufmerksamkeit konkurriert. Der vollständige Prompt, exakt wie eingereicht:

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. Promo-Banner mit gerendertem Text

Hier kommt das Text-Rendering der Pro-Stufe ins Spiel. Der Prompt verlangt zwei Zeilen konkreten Aktions-Text in bestimmten Ecken – kein Platzhaltertext, kein „hier deinen Text einfügen“:

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

Laut dem Content-Playbook von hiapi darf gerenderter Text niemals ohne menschliches Korrekturlesen ausgeliefert werden – KI-Text-Rendering ist zuverlässig, aber nicht unfehlbar; gelegentliche fehlende Buchstaben oder Laufweitenfehler zeigen sich erst bei der Prüfung. Dieses Banner wurde vor der Veröffentlichung auf dieser Seite Zeichen für Zeichen gegen den Prompt abgeglichen.

3. Varianten-Raster

Für Katalogseiten, die jede Variante oder jeden Duft auflisten, hält ein gekacheltes Raster jede Variante visuell konsistent:

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

Beachte die leeren Etiketten auf allen drei Bildern – SKU-spezifische Etiketten (Markenname, Duft, Größe) sind kleine Schrift auf kleinen Flächen, ein deutlich schwierigeres Rendering-Ziel als eine Banner-Überschrift. Das praktische Muster: Flaschen mit leeren Etiketten generieren und dann den Etikettentext in der Nachbearbeitung compositen. Und wenn sich Aktionspreise ändern, lässt sich das so auch schneller aktualisieren.

Das Input-Schema, gegen die Live-API verifiziert

Das /v1/tasks-Schema von qwen-image-2.0-pro ist strenger, als es aussieht – kein aspect_ratio, kein n und überhaupt kein Bild-Input-Feld:

Feld	Typ	Erforderlich	Werte
prompt	string	✅	Deine Shot-Beschreibung
size	string	✅	2048*2048, 2688*1536, 2368*1728, 1728*2368, 1536*2688
negative_prompt	string	optional	Inhalte, die ausgeschlossen werden sollen
seed	integer	optional	Für Reproduzierbarkeit
watermark	boolean	optional
prompt_extend	boolean	optional	Lässt das Modell kurze Prompts erweitern

Zwei Dinge sind für jeden bemerkenswert, der Requests von anderen hiapi-Bildmodellen portiert: Es gibt hier keinen aspect_ratio-Parameter (verwende direkt size), und dieses Modell unterstützt ausschließlich Text-zu-Bild – es gibt kein Referenzbild-Feld, du kannst ihm also kein Foto deines tatsächlichen Produkts geben und eine Variante verlangen. Prompt-Steuerung ist das einzige Mittel. Die vollständige Request-/Response-Struktur und Fehlerbeispiele findest du im API-Tutorial; diese Seite konzentriert sich auf den E-Commerce-Anwendungsfall.

Batch-Skript: drei Assets, eine Submit-Schleife

Da /v1/tasks asynchron ist, sind Hero-Bild, Banner und Raster nur drei Submits plus drei Polls – kein serielles Warten nötig:

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)

Im Test dauerte ein Rendering im Bereich von etwa 2000 px jeweils ungefähr eine Minute; bei Spitzenlast solltest du pro Bild einige Minuten einplanen, bevor du es als Timeout behandelst.

Pro vs. Basis-Stufe: Welche verwenden

Beide Stufen teilen dasselbe prompt + size-Schema, sodass der Wechsel zwischen ihnen nur eine Zeile im model-Feld erfordert:

	qwen-image-2.0 (Basis)	qwen-image-2.0-pro
Preis	$0.025/Bild	$0.107/Bild
Max. Größe	2048×2048	2048×2048
Text-Rendering	Gut	Stärker – die Standardwahl für Aktions-Text
Fotorealistische Details	Gut	Feiner – die Standardwahl für Hero-Bilder
Am besten geeignet für	Prompt-Exploration, großvolumige Entwürfe, interne Renderings	Finale Hero-/Banner-Assets, alles mit gerendertem Text

Die praktische Aufteilung für echte Kataloge: Kompositionen auf der Basis-Stufe entwerfen, wo eine Iterationsrunde günstig ist, und dann die ausgewählten Favoriten auf der Pro-Stufe für die tatsächlich ausgelieferten Assets neu rendern. Den Basis-Stufen-Workflow – dieselbe Task-API, derselbe Prompt-Stil – findest du unter E-Commerce-Produktbilder mit qwen-image-2.0 generieren.

Tipps für Produktfoto-Prompts

Was über diese drei Renderings hinweg durchgehend funktioniert hat:

• Oberfläche und Licht benennen, nicht nur das Motiv. „Travertin-Sockel“, „weiches diffuses Hauptlicht von links oben“ tragen mehr zum Fotorealismus bei als Adjektive wie „professionell“ oder „hochwertig“.
• Bei Bildern ohne Text „kein Text, keine Logos“ angeben. Ohne diese Angabe tragen Produktfoto-Prompts gelegentlich verirrte Etikettenspuren mit; eine explizite negative Vorgabe hält das Produktbild sauber.
• Für Banner den exakten Text in äquivalenter zitierter Sprache ausschreiben. „Fetter, sauberer weißer Sans-Serif-Text mit der Aufschrift SUMMER GLOW SALE“ wird exakt gerendert; ein vageres „etwas Aktions-Text“ überlässt die Formulierung dem Zufall.
• Auf Verpackungen leere Etiketten statt winziger Markentexte verlangen. Kleine Textflächen sind das schwierigste Rendering-Ziel für jedes Bildmodell – stattdessen in der Nachbearbeitung compositen.

FAQ

Kann ich qwen-image-2.0-pro ein Foto meines tatsächlichen Produkts geben, um Varianten zu generieren? Nein – dieses Modell unterstützt ausschließlich Text-zu-Bild, sein Schema hat kein Bild-Input-Feld. Für Image-to-Image-Workflows brauchst du ein anderes Modell auf hiapi, das i2i explizit unterstützt.

Ist gerenderter Text zuverlässig genug, um ihn ohne Prüfung auszuliefern? Nein – er ist zuverlässig, aber nicht perfekt. Lies ihn vor der Veröffentlichung Zeichen für Zeichen gegen den Prompt und generiere bei den seltenen Fehlern neu. Siehe den Hinweis unter dem Promo-Banner oben.

Welche Größe sollte ich für Listing-Hero-Bilder und Banner verwenden? Quadratisches 2048*2048 deckt die Listing-Anforderungen der meisten Marktplätze ab. Für breite Promo-Banner oder Hero-Karussells kommen 2688*1536 oder 2368*1728 (Quer-/Hochformat) gängigen Web-Banner-Seitenverhältnissen näher, ohne Nachbeschneiden.

Bietet die Pro-Stufe Mengenrabatte? Nein – die Preisgestaltung liegt fest bei $0.107 pro Bild, unabhängig von der Menge; der Kostenhebel liegt darin, wie viele Bilder du generierst, nicht in Staffelpreisen.

Fazit

Für E-Commerce-Kataloge fallen die Vorteile von qwen-image-2.0-pro gegenüber der Basis-Stufe genau dort an, wo Produktfotografie sie braucht: sauberere fotorealistische Details bei Hero-Bildern, zuverlässiges Text-Rendering bei Promo-Bannern, und das zu einem weiterhin moderaten Preis von $0.107/Bild. Reiche Hero-, Banner- und Varianten-Raster-Requests parallel über /v1/tasks ein, korrigiere vor der Auslieferung jeden gerenderten Text und wechsle zur Basis-Stufe, wenn du Kompositionen iterierst statt finale Assets zu liefern. Die qwen-image-2.0-pro Modellseite hat Live-Preise und eine Parameterreferenz, um von hier aus weiterzumachen.