Benutzerhandbuch
Wan 2.7 Text-zu-Bild für E-Commerce-Produktfotografie: 4K-Studioqualität mit einem einzigen API-Aufruf
Ein praxiserprobter Workflow mit wan2.7-image/text-to-image auf hiapi zur Erzeugung von Hauptbildern, Szenenbildern, Verpackungsbildern und 4K-Makroaufnahmen – inklusive präziser Prompts, echter Laufzeiten und einheitlicher Preisgestaltung von $0.08
Jedes Bild in diesem Leitfaden wurde während des Verfassens über die hiapi Task-API mit wan2.7-image/text-to-image erzeugt – die gezeigten Prompts sind die tatsächlich verwendeten Prompts, und die Laufzeiten sind die realen Wanduhrzeiten dieser Läufe. Wenn Sie online verkaufen und Listing-Bilder, Szenenbilder, Verpackungs-Mockups oder zoombare Detailaufnahmen benötigen, ohne ein Studio buchen zu müssen, ist dies der Workflow für Sie.

Warum Wan 2.7 Image für Produktfotografie verwenden
Wan 2.7 Image Pro (Modell-ID wan2.7-image/text-to-image) ist das Flaggschiff-Text-zu-Bild-Modell von Tongyi Wanxiang. Drei Eigenschaften machen es besonders geeignet für E-Commerce-Arbeit:
- Ausgabe bis 4K. Zoom-Viewer von E-Commerce-Plattformen und Print-on-Demand wünschen mehr Pixel als der übliche 1K-Standardwert. Wan 2.7 unterstützt nativ 4096×4096 – kein Upscaling nötig.
- Starke Prompt-Befolgung. Produktbilder sind kompositorisch: diese Flasche, auf jener Oberfläche, beleuchtet von dieser Seite. In unseren Läufen wurden Materialbeschreibungen („frosted glass“, „brushed aluminum“), Lichtrichtungen und Requisitenplatzierung auf Anhieb korrekt umgesetzt.
- Einheitliche Preisgestaltung. Auf hiapi kostet jedes Bild $0.08, unabhängig von der Auflösung – 1K, 2K und 4K werden gleich abgerechnet (geprüft anhand der aktuellen Preisseite). Die meisten Premium-Modelle erheben einen Zuschlag für 4K, daher ist der Pauschaltarif die wirtschaftlichere Wahl, wenn Ihr Workflow überwiegend auf 4K setzt. Weitere Vergleiche finden Sie unten.
Es akzeptiert außerdem sowohl englische als auch chinesische Prompts, was wichtig ist, wenn Ihr Produkttexterteam Chinesisch verwendet, Ihr Shop sich aber an englischsprachige Nutzer richtet.
Schnellstart: ein POST, ein Polling
Wan 2.7 Image läuft auf der asynchronen Task-API von hiapi. Sie reichen einen Task ein, pollen, bis er abgeschlossen ist, und laden dann die Ausgabe herunter. Holen Sie sich zunächst einen API-Schlüssel über die Schnellstartanleitung.
Einreichen:
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"
}
}'
Die Antwort enthält die Task-ID in data.taskId. Pollen Sie den Detail-Endpunkt, bis status gleich success ist:
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
In unseren Läufen kam die Task-Erstellung nach etwa 2 Sekunden zurück, die 2K-Generierung war in 60–75 Sekunden abgeschlossen, und 4K-Bilder brauchten 86 Sekunden. Rechnet man den Polling-Overhead hinzu, sollten Sie etwa anderthalb Minuten pro Bild einplanen.
Bevor Sie dies in die Produktion einbinden, gibt es zwei betriebliche Hinweise:
- Ausgabe-URLs laufen ab.
output[0].urlenthält einenexpireAt-Zeitstempel – es ist ein temporärer Link, keine CDN-Ressource. Laden Sie die Bytes in dem Moment herunter, in dem der Task erfolgreich ist, und speichern Sie sie in Ihrem eigenen Speicher. Falls Sie schon einmal von diesem Problem betroffen waren: Wir haben das Fehlermuster in Warum Ihre hiapi-Ausgabe-URL 404 zurückgibt und was Sie dagegen tun können beschrieben. - Die Liste der Seitenverhältnisse ist strikt. Wan 2.7 Image akzeptiert nur
1:1,16:9,4:3,21:9,3:4,9:16,8:1,1:8. Jedes andere Verhältnis – einschließlich gängiger Fotoformate wie3:2und4:5– führt zu400 INVALID_REQUEST, wobei die Meldung die zulässige Liste enthält. Wir sind tatsächlich darauf gestoßen: Eine Anfrage mit 1536×1920 (was sich zu 4:5 vereinfachen lässt) wurde abgelehnt; eine erneute Einreichung mit3:4war erfolgreich. Wenn Sie das 4:5-Format von Instagram benötigen, generieren Sie3:4und schneiden Sie anschließend zu.
Die vier Bildtypen, die jedes Produktlisting braucht
Im Folgenden finden Sie vier typische E-Commerce-Bildtypen, jeweils mit dem tatsächlich verwendeten Prompt und der unbearbeiteten Ausgabe.
1. Hauptbild auf weißem Hintergrund
Amazon, eBay und die meisten E-Commerce-Plattformen verlangen für das Hauptlisting-Bild einen reinweißen Hintergrund. Die entscheidenden Punkte im Prompt: Geben Sie den Hintergrund explizit an („seamless pure white background“), fordern Sie einen „gentle contact shadow“ an, damit das Produkt nicht zu schweben scheint, und beschreiben Sie die Beleuchtung wie ein Fotograf.
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

Generiert mit 1:1 / 2K, Laufzeit 61 Sekunden. Die Materialwiedergabe – das matte Glas, durch das der Tropfer diffus sichtbar ist, die gebürstete Metallstruktur auf der Kappe – ist genau das, was „starke Prompt-Befolgung“ bewirkt.
2. Szenenbild
Sekundäre Listing-Bilder vermitteln den Nutzungskontext. Platzieren Sie das Produkt dort, wo Kunden es sich in der Anwendung vorstellen, und lassen Sie den Prompt die Styling-Anforderungen tragen: Oberfläche, Requisiten, Lichtrichtung, Schärfentiefe.
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

Jedes geforderte Element war vorhanden: Marmortheke, gefaltetes Handtuch, Eukalyptus, Fensterlicht von links, Hintergrundabfall. Dies ist der Bildtyp, bei dem Prompt-Befolgung am wichtigsten ist, denn eine einzige überflüssige oder fehlende Requisite bedeutet eine Neugenerierung.
3. Verpackungsbild mit lesbarem Markentext
Textwiedergabe ist der Bereich, in dem die meisten Bildmodelle bei Produktaufgaben versagen. Kurze, eindeutige Texte werden mit Wan 2.7 zuverlässig gerendert – setzen Sie die exakte Zeichenkette in Anführungszeichen und beschreiben Sie die Typografie:
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“ wurde exakt richtig gerendert. Eine ehrliche Warnung aus unseren Testläufen: Das gilt für kurze Zeichenketten, die Sie ausdrücklich angeben. Als ein früher Entwurf unseres Bannerbildes die Beschriftung dem Modell überließ, erfand es plausible Kauderwelsch-Texte auf den Flaschen („SERUM SERUE“) – zitieren Sie also entweder den gewünschten exakten Text oder fordern Sie „no labels, no text, no logos“ an und fügen Sie Beschriftungen später hinzu. Korrigieren Sie vor der Veröffentlichung immer jeglichen Text in generierten Bildern.
4. 4K-Makro-Detailaufnahme
Zoom-Detailaufnahmen rechtfertigen Premium-Preise. Hier kommen 4K-Ausgabe und Pauschaltarif ins Spiel – derselbe Preis von $0.08 für eine Datei mit 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

Die Datei in voller Auflösung hat 4096×4096 (optimiertes JPEG, ca. 1,2 MB) und bleibt im Zoom-Viewer von E-Commerce-Plattformen ohne jedes Upscaling scharf.
Vergleich für E-Commerce-Workloads
Alle folgenden Preise sind die aktuellen Preise pro Bild auf hiapi zum Zeitpunkt des Verfassens – prüfen Sie die Preisseite für die aktuellen Zahlen.
| Modell | 1K | 2K | 4K | Am besten geeignet für |
|---|---|---|---|---|
wan2.7-image/text-to-image |
$0.08 | $0.08 | $0.08 | 4K-lastige Workflows, prompt-intensive Kompositionen |
gpt-image-2/text-to-image |
$0.03 | $0.04 | $0.06 | Kataloge mit hohem Volumen, bei denen 1K–2K ausreichen |
nano-banana |
$0.05 | — | — | Geschwindigkeit (1–2 Sekunden pro Bild), schnelle Iteration |
nano-banana-pro |
$0.17 | $0.17 | $0.2992 | High-End-Markenmaterial, umfangreiche Textwiedergabe |
Unsere empfohlene Entscheidungsregel: Wenn Ihre Listings 4K benötigen, ist Wan 2.7 die günstigste 4K-Option in der Produktpalette, und der Pauschaltarif macht die Kostenprognose sehr einfach. Wenn 1K–2K ausreichen und das Volumen begrenzend wirkt, ist gpt-image-2 der Budget-Arbeitsgaul. Wenn Sie die Komposition vor der Festlegung Dutzende Male iterieren müssen, halten die 1–2-Sekunden-Generierungen von nano-banana den Zyklus schnell – rendern Sie dann das Gewinner-Design mit Wan 2.7 in 4K neu.
Ein vollständiges Produktlisting – Hauptbild, Szenenbild, Verpackungsbild, Makroaufnahme – kostet auf Wan 2.7 $0.32 und benötigt bei paralleler Ausführung der Tasks weniger als fünf Minuten Wanduhrzeit.
Zusammenfassung
wan2.7-image/text-to-image liefert E-Commerce-Teams Produktfotografie in Studioqualität mit einem einzigen asynchronen API-Aufruf: einheitlich $0.08 für jede Auflösung bis 4K, starke Befolgung kompositorischer Anforderungen und zuverlässige Wiedergabe kurzer Texte auf Verpackungen. Beachten Sie die strikte Liste der Seitenverhältnisse, laden Sie die Ausgabe herunter, bevor die URL abläuft, und korrigieren Sie jeglichen generierten Text.
Bereit, es in Ihrem eigenen Katalog auszuprobieren? Holen Sie sich einen API-Schlüssel, beginnen Sie auf der Modellseite von Wan 2.7 Image Pro, und die Schnellstartanleitung für die asynchrone API wird Ihr erstes 4K-Produktbild in etwa neunzig Sekunden rendern.
Ähnliche Artikel
Alle Artikel ansehen →-
Benutzerhandbuch
seedream-5.0-pro/image-to-image Erste-Schritte-Leitfaden: Fähigkeiten, Preise und Integrationspunkte
Fähigkeitsgrenzen, Abrechnungsmodell und Engineering-Integration des Bildbearbeitungsmodells von ByteDance
-
Benutzerhandbuch
seedream-5.0-pro Text-zu-Bild Einstiegsleitfaden: Fähigkeitsgrenzen, API-Integration und Kostenkontrolle
Praxisorientierte Perspektive für Entwickler: von den wichtigsten Parametern bis zur Kostenschätzung von $0,05 pro Bild
-
Benutzerhandbuch
Hailuo 2.3 Fast Bild-zu-Video-Anleitung: Grenzen der Leistungsfähigkeit, Preisgestaltung und Integration in die Praxis
MiniMax Bild-zu-Video-Modell für Entwickler: Auswahlkriterien und Integrationspunkte