flux-2 für E-Commerce-Produktbilder: eine praktische Anleitung zur hiapi-API

TL;DR

• Worum es geht: Eine praktische Anleitung zur Erzeugung von E-Commerce-Produktbildern mit flux-2/text-to-image auf hiapi. Jedes Bild auf dieser Seite wurde mit exakt dem Prompt erzeugt, der direkt darüber abgedruckt ist – keine geliehenen Demos –, sodass du jedes einzelne reproduzieren kannst.
• Warum flux-2 für Produktbilder geeignet ist: Das Modell setzt auf Prompt-Treue und hohe Wiedergabetreue – genau das, was Katalogarbeit erfordert: exakte Artikelanzahl, bestimmte Farben, sauberer nahtloser Hintergrund und leere (textfreie) Etiketten werden strikt befolgt.
• Modellfakten (auf der API verifiziert): flux-2 läuft über den asynchronen Task-Endpunkt (/v1/tasks). input.resolution verwendet das Megapixel-Format – 0.5 MP, 1 MP, 2 MP oder 4 MP – und nicht 1K/2K. aspect_ratio ist optional und akzeptiert Werte wie 1:1, 3:2, 16:9.
• Preise (pro Bild): 0.5 MP kostet $0.0375, 1 MP $0.05, 2 MP $0.075 und 4 MP $0.125. Aktuelle Preise findest du unter Preise.
• So funktioniert es: Sende einen POST-Request an die Task-API, polle, bis der Status success lautet, und lade dann das Bild von output[0].url herunter (diese URL läuft ab – speichere die Bytes sofort). Das vollständige Copy-and-paste-Skript steht am Ende, inklusive einer Batch-Schleife.

Warum flux-2 für Produktfotografie geeignet ist

Die meisten Text-zu-Bild-Modelle können einen schönen Becher zeichnen. Beim E-Commerce geht es nicht um „schön“, sondern um Präzision. Produktlisten brauchen die richtige Farbe, die richtige Artikelanzahl, einen sauberen Hintergrund mit Platz für deinen eigenen Text und Etiketten, die leer bleiben, damit du später echten Text einfügen kannst. Wenn das Modell frei improvisiert – eine zusätzliche Flasche zeichnet, Etikettentext erfindet, den weißen Hintergrund einfärbt –, ist das Bild nicht listenfähig.

flux-2 ist mit Prompt-Treue und hoher Wiedergabetreue ausgezeichnet, was in der Praxis bedeutet, dass es dazu neigt, den Prompt buchstäblich zu befolgen. Genau das ist bei Katalogbildern entscheidend: Du schreibst die Vorgaben, das Modell hält sie ein, statt sie „kreativ zu interpretieren“. Die folgenden Rezepte sind genau darauf aufgebaut – jedes stützt sich auf eine bestimmte Vorgabe (Anzahl, Farbe, Layout), damit du die Prompt-Treue selbst siehst.

So liest du diese Rezepte

Jedes Rezept besteht aus drei Teilen: einer Zeile mit dem Ziel, dem exakten Prompt (zum unveränderten Kopieren) und dem daraus erzeugten Bild. Jeder Prompt wurde von mir verfasst und über die tatsächliche Task-API auf flux-2 ausgeführt. Einige Gewohnheiten, die bei diesem Modell zuverlässig funktionieren:

• Den Hintergrund ausdrücklich nennen. „Nahtloser hellgrauer Studiohintergrund“ ist besser als es dem Zufall zu überlassen und macht das Bild direkt für die Produktdetailseite (PDP) verwendbar.
• „Kein Text, kein Logo“ schreiben, wenn du leere Etiketten willst. flux-2 hält sich daran, sodass du nachgelagert echtes Branding hinzufügen kannst.
• Zählbare, überprüfbare Vorgaben machen. „Genau drei Flaschen“, „links bernsteinfarben, in der Mitte transparent, rechts türkis“ – konkrete Anweisungen sind der Punkt, an dem Prompt-Treue zum Tragen kommt.
• Negativen Raum im Prompt vorsehen („oben viel Freiraum für eine Überschrift“), besonders wenn das Bild unter überlagertem Text platziert wird.

Rezept 1 – Sauberer Freisteller auf weißem Hintergrund

Ziel: Das einfachste Produktlistenbild – ein Produkt, nahtloser Hintergrund, gleichmäßige Ränder, direkt auf die Produktseite übertragbar.

A single matte-white ceramic coffee mug centered on a seamless light-grey studio background, three-quarter front angle, empty and unbranded. Soft even top-light with one subtle rim highlight down the left edge, a soft grounded contact shadow beneath. Studio e-commerce packshot, perfectly centered, wide even margins on all sides, photoreal, high detail, no text, no logo.

Ränder und Zentrierung stammen direkt aus dem Prompt – fordere sie ausdrücklich an, damit der Zuschnitt im Listing-Raster verwendbar ist.

Rezept 2 – Prompt-Treue-Test

Ziel: Beweisen, dass das Modell präzise, zählbare Anweisungen befolgt – genau der Grund, warum für Produktarbeit überhaupt flux-2 gewählt wird.

Product photo of exactly three glass spray bottles standing in a row on a white acrylic surface: the left bottle filled with pale amber liquid, the middle bottle filled with clear liquid, the right bottle filled with soft teal liquid. All three have matte-black fine-mist pump tops and blank labels with no writing. Even frontal studio light, soft reflections on the acrylic, seamless white background. Photoreal commercial product photography, sharp focus, no text anywhere in the image.

Zähle nach: drei Flaschen, nicht vier. Von links nach rechts sind die Füllungen Bernstein, transparent, Türkis – in der richtigen Reihenfolge. Die Pumpköpfe sind mattschwarz. Die Etiketten sind leer, sodass später echter Text hinzugefügt werden kann. Das ist der Lohn – du gibst vor, es hält sich daran, und das Bild ist direkt verwendbar.

Rezept 3 – Lifestyle-/Szenenbild

Ziel: Das Produkt in eine Szene setzen, ohne es zu verstecken – ein „In-Use“-Bild, das neben dem Freisteller in der Produktliste erscheint.

Lifestyle e-commerce shot of a tan leather crossbody bag resting on a pale oak cafe table beside a folded newspaper and a cup of espresso, soft morning window light from the left, warm out-of-focus cafe interior in the background with creamy bokeh. The bag is the clear hero, sharp and well-lit, staged naturally but uncluttered. Photoreal, editorial product-in-use photography, warm neutral palette, shallow depth of field, no visible brand marks or text.

Den Helden klar zu benennen („die Tasche ist der eindeutige Held, scharf“) und alles andere in die Unschärfe zu rücken, hält das Produkt erkennbar und erzählt trotzdem eine Geschichte – genau die Balance, die ein Lifestyle-Bild braucht.

Rezept 4 – Mehrwinkel-PDP-Set

Ziel: Ein Winkel-Set für die Produktdetailseite – mehrere konsistente Ansichten desselben Artikels, die in Licht und Maßstab übereinstimmen.

A clean product-detail-page angle set of one pair of low-top canvas sneakers in off-white, shown as three separate views arranged left to right on a seamless light-grey background: a straight side profile, a three-quarter front angle, and a top-down overhead view. Consistent soft studio lighting and identical scale across all three, even spacing, soft contact shadows. Catalog-grade e-commerce photography, photoreal, crisp, unbranded, no text or labels.

Erst die Vorgabe „konsistente Beleuchtung und identischer Maßstab über alle drei Ansichten“ lässt das Set wie ein einziges Produkt wirken statt wie drei lose Renderings. Es ersetzt kein echtes 360-Grad-Rig, ist aber ein schneller Weg, das PDP-Layout vor einem echten Shooting zu skizzieren.

flux-2 über die Task-API ausführen

flux-2 verwendet das asynchrone Task-Protokoll von hiapi – du erstellst einen Task, pollst ihn und lädst dann das Ergebnis herunter. Das Einzige, was du richtig machen musst: resolution ist im Megapixel-Format. Sende "1 MP", nicht "1K", sonst gibt die API 400 zurück und meldet, dass der Wert einer von 0.5 MP / 1 MP / 2 MP / 4 MP sein muss.

1. Task erstellen

curl -s https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-2/text-to-image",
    "input": {
      "prompt": "A single matte-white ceramic coffee mug centered on a seamless light-grey studio background, three-quarter front angle, soft even top-light, photoreal e-commerce packshot, no text, no logo",
      "aspect_ratio": "1:1",
      "resolution": "1 MP"
    }
  }'
# -> {"code":200,"data":{"taskId":"tk-hiapi-..."},"message":"success"}

2. Pollen, bis der Task fertig ist, dann herunterladen

import os, time, requests

TOKEN = os.environ["HIAPI_TOKEN"]
BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": f"Bearer {TOKEN}"}


def generate(prompt, aspect_ratio="1:1", resolution="1 MP"):
    # create
    r = requests.post(BASE, headers=HEADERS, json={
        "model": "flux-2/text-to-image",
        "input": {"prompt": prompt, "aspect_ratio": aspect_ratio, "resolution": resolution},
    }).json()
    task_id = r["data"]["taskId"]

    # poll (a single image usually lands well under two minutes)
    deadline = time.time() + 600
    while time.time() < deadline:
        task = requests.get(f"{BASE}/{task_id}", headers=HEADERS).json()["data"]
        if task["status"] == "success":
            # output[0].url is a temporary link — download the bytes now
            url = task["output"][0]["url"]
            return requests.get(url, timeout=120).content
        if task["status"] == "fail":
            raise RuntimeError(task.get("error"))
        time.sleep(5)
    raise TimeoutError(task_id)


img = generate("A single matte-white ceramic coffee mug on a seamless light-grey background, photoreal e-commerce packshot, no text")
open("mug.jpg", "wb").write(img)

Die URL in output[0].url enthält einen expireAt-Zeitstempel – sie ist ein kurzlebiger Link. Lade die Bytes sofort herunter und übertrage sie in deinen eigenen Speicher; verlinke sie nicht direkt in einer Live-Produktliste.

Den gesamten Katalog im Batch generieren

Für einen echten Shop erstellst du nicht nur ein Bild – sondern eines pro SKU. Führe eine Liste mit Prompts, verwende die obige Funktion generate() erneut und speichere jedes Ergebnis unter dem Namen seines SKU:

catalog = {
    "SKU-1001": "A single matte-white ceramic coffee mug on a seamless light-grey studio background, three-quarter angle, soft even top-light, photoreal e-commerce packshot, no text, no logo",
    "SKU-1002": "A tan leather crossbody bag on a seamless light-grey studio background, front-on, soft studio light, grounded contact shadow, photoreal packshot, no visible brand marks",
    "SKU-1003": "A pair of off-white low-top canvas sneakers, side profile, seamless light-grey background, crisp catalog lighting, photoreal, unbranded, no text",
}

for sku, prompt in catalog.items():
    img = generate(prompt, aspect_ratio="1:1", resolution="1 MP")
    open(f"{sku}.jpg", "wb").write(img)
    print(f"{sku} done")

Bevor du skalierst, solltest du einige Dinge wissen:

• Die Auflösung bestimmt die Kosten. Bei 1 MP kostet jedes Bild $0.05; erhöhe nur bei Flaggschiff-Bildern, bei denen das zusätzliche Detail es wert ist, auf 2 MP ($0.075) oder 4 MP ($0.125). Ein Katalog mit 200 SKUs kostet bei 1 MP etwa $10. Sieh dir vor der Budgetierung die Preise für aktuelle Zahlen an.
• Tasks parallel ausführen. Jeder SKU ist ein unabhängiger Task – erstelle mehrere Tasks und polle sie parallel statt nacheinander; große Batches lassen sich so in sehr kurzer Wanduhrzeit abschließen.
• Die „Style“-Klausel konsistent halten. Achte auf den gemeinsamen Abschluss in jedem Prompt oben („nahtloser hellgrauer Studiohintergrund … fotorealistischer Packshot, kein Text“). Fixiere diese Formulierung, damit eine Bildcharge wie ein Katalog wirkt und nicht wie ein Sammelsurium.

Das Wichtigste

• Die Stärke von flux-2 bei Produktarbeit ist die strikte Umsetzung deiner wörtlichen Vorgaben – exakte Anzahl, exakte Farben, leere Etiketten –, also schreibe die Vorgaben ausdrücklich hin, damit es sie befolgt.
• Nenne im Prompt immer den Hintergrund und sieh negativen Raum vor; das macht die Renderings direkt für Produktlisten verwendbar.
• Sende resolution in der Task-API im Megapixel-Format (1 MP), polle /v1/tasks/{id} bis success und lade herunter, bevor output[0].url abläuft.
• Der Preis steigt mit der Auflösung – 1 MP für Katalog-Batches, 2 MP/4 MP für Flaggschiff-Bilder.

Bereit, es auszuprobieren? Hole dir einen Schlüssel, richte model auf flux-2/text-to-image und sieh dir die Live-Tarife auf der Preisseite an, bevor du deinen Katalog im Batch generierst.