Benutzerhandbuch

FLUX 1.1 Pro für E-Commerce-Produktbilder: Der hiapi API-Leitfaden

Jul 3, 2026

Wer online verkauft, kennt die Rechnung längst: Eine Produktdetailseite braucht ein Freistellerbild auf weißem Hintergrund, ein Lifestyle-Bild und idealerweise eine Reihe von Mehrwinkelaufnahmen – für jede SKU und jede Farbvariante. Ein Studiotag schafft zehn Produkte, eine Bild-API schafft tausend.

flux-1.1-pro (FLUX.1.1 [pro] von Black Forest Labs) ist das fotorealistische Arbeitspferd auf hiapi: Es rendert überzeugende Materialien – gebürstetes Metall, Glas, Stoff, sanftes Bokeh – zu einem einheitlichen Preis von 0,05 $ pro Bild. Dieser Leitfaden ist ein direkt umsetzbares E-Commerce-Rezept: Jedes Bild unten wurde mit dem unmittelbar darüber abgedruckten Prompt erzeugt, über denselben /v1/tasks-Aufruf, den Sie direkt kopieren und einfügen können, und wir haben die tatsächlichen Parameterbereiche dokumentiert – einschließlich der Parameter, die zu existieren scheinen, aber bei Versand sofort einen 400 zurückgeben.

Die API in 60 Sekunden verstehen

Auf hiapi läuft flux-1.1-pro über einen asynchronen Task-Endpunkt. Sie erstellen einen Task, pollen ihn und laden das Ergebnis herunter:

# 1. Create the task
curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-1.1-pro",
    "input": {
      "prompt": "Studio packshot of an unbranded stainless steel wristwatch...",
      "aspect_ratio": "1:1",
      "output_format": "jpg",
      "seed": 6607
    }
  }'
# => {"code":200,"data":{"taskId":"tk-hiapi-01KWK3JG..."},"message":"success"}

# 2. Poll until status is "success" (typically 10–40s for flux-1.1-pro)
curl https://api.hiapi.ai/v1/tasks/tk-hiapi-01KWK3JG... \
  -H "Authorization: Bearer $HIAPI_API_KEY"

# 3. Download output[0].url — it carries an expireAt timestamp,
#    so save the file to your own storage immediately.

Bevor es ans Eingemachte geht, zwei Betriebshinweise:

Ausgabe-URLs sind temporär. Laden Sie sofort herunter und speichern Sie selbst, sobald der Task erfolgreich ist – siehe Was passiert, wenn eine hiapi-Ausgabe-URL abläuft.
Wenn ein Task länger als erwartet im Status processing verweilt, reichen Sie ihn nicht blind erneut ein; hier finden Sie einen Diagnoseleitfaden für hängende oder timeoutete Tasks.

Die tatsächlichen Parameterbereiche (und die 400er, die Sie beim Raten treffen)

Wenn Sie FLUX-Modelle auf anderen Plattformen verwendet haben, verleitet Sie das Muskelgedächtnis dazu, steps und guidance anzupassen. Im Task-Schema von hiapi für flux-1.1-pro existieren diese Felder jedoch nicht – die API validiert Eingaben strikt und lehnt unbekannte Eigenschaften ab:

{
  "code": 400,
  "error_code": "INVALID_REQUEST",
  "message": "invalid input: <root>: additional properties 'steps', 'guidance' not allowed"
}

Das ist kein Bug; FLUX 1.1 [pro] wird als gehosteter Endpunkt bereitgestellt, die Sampling-Interna werden vom Anbieter festgelegt. Folgendes können Sie senden – validiert gegenüber dem Live-Schema:

Feld	Typ	Akzeptierte Werte / Bereich
`prompt`	string	erforderlich
`aspect_ratio`	string	`1:1`, `16:9`, `9:16`, `3:2`, `2:3`, `4:3`, `3:4`, `4:5`, `5:4`, `custom`
`width`, `height`	integer	256–1440 px (statt Seitenverhältnis verwenden oder in Kombination mit `custom`-Seitenverhältnis)
`seed`	integer	beliebige Ganzzahl – fixiert die Komposition für Reproduzierbarkeit
`output_format`	string	`jpg`, `png`, `webp`
`prompt_upsampling`	boolean	lässt das Backend Ihren Prompt umschreiben/erweitern
`safety_tolerance`	integer	0–6

Praktische Standardwerte für Produktbilder: output_format: "jpg", ein explizites aspect_ratio je Platzierung (1:1 für Shop-Raster, 4:5 für Feed/Lifestyle, 3:2 oder 1440×960 für Banner), ein fester seed pro SKU-Serie und prompt_upsampling aus – im E-Commerce möchten Sie, dass das Modell sich strikt an Ihre Formulierung hält und nicht selbst kreativ wird.

Rezept 1 – Sauberer Freisteller auf weißem Hintergrund

Das Basisbild: ein Produkt, nahtloser Hintergrund, weiches Hauptlicht. Nennen Sie die Hintergrundfarbe explizit, fordern Sie eine Bodenreflexion an und – wichtig bei jedem fotorealistischen Modell – schreiben Sie unbedingt „markenlos, kein Logo, kein Text“. Zifferblätter und Etiketten sind genau die Stellen, an denen FLUX sonst Markenformen hinkritzeln könnte, die Sie anschließend retuschieren müssten.

Studio packshot of an unbranded stainless steel wristwatch with a plain deep green dial and brushed metal bracelet, the dial completely clean with simple baton hour markers and no logo, no brand name, no text or numerals anywhere, standing upright on a seamless light grey background, centered composition, soft diffused key light from the upper left, subtle reflection beneath the watch, photorealistic e-commerce product photography

Senden Sie mit aspect_ratio: "1:1", seed: 6607. Die gebürstete Metalloptik und die weiche Bodenreflexion sind genau das, wofür Sie in der Profiklasse 0,05 $ zahlen – billige Modelle plätten genau diese Details weg.

Rezept 2 – Lifestyle-Bild

Das Shop-Raster braucht Freisteller; Produktseiten und Social Media konvertieren über Szenen. Setzen Sie das Produkt in eine Szene, lassen Sie das Etikett leer und vermitteln Sie mit geringer Schärfentiefe „Premium“-Gefühl. 4:5 passt zum Feed-Zuschnitt.

A lit soy candle in a clear glass jar with a plain blank kraft-paper label, on a rustic oak nightstand next to a stack of two linen-bound books, warm evening window light, softly blurred bedroom background, cozy lifestyle product photography for an online store, photorealistic

Senden Sie mit aspect_ratio: "4:5", seed: 7301. Beachten Sie, dass das leere Etikett erhalten bleibt – das ist Ihre Leinwand, auf die Sie später das echte Markenmotiv compositen.

Rezept 3 – Farbvarianten mit festem Seed

Das ist der kostensparendste Trick bei der Katalogproduktion. Der seed fixiert die Rauschinitialisierung: Wenn Sie Seed und Prompt-Struktur exakt gleich halten und nur die Farbwörter ändern, erhalten Sie dieselbe Komposition in einer neuen Farbe – kein erneutes Shooting, kein img2img-Workflow.

Beide Bilder unten verwenden seed: 5150, aspect_ratio: "1:1", und die Prompts unterscheiden sich in exakt zwei Wörtern (navy blue → coral pink):

A single insulated stainless steel water bottle in matte navy blue, standing on a round travertine stone slab against a soft warm beige studio background, centered, soft diffused lighting, minimalist e-commerce product photo, photorealistic

Gleiche Flaschenkontur, gleiche Steinplatte, gleiche Komposition – andere SKU. Das ist ein fest geseedeter Prompt, der einen Tag Varianten-Shooting ersetzt.

Batch: den gesamten Katalog pro SKU rendern

So sieht das Muster aus, das wir tatsächlich ausgeführt haben: übermitteln, pollen, herunterladen, wiederholen. Produktionsläufe zeigen einen Punkt, den Sie vorab einplanen sollten: flux-1.1-pro-Tasks schlagen gelegentlich mit einem generischen {"code": "TASK_FAILED"} fehl – das ist transient, dieselbe Eingabe führt bei erneuter Übermittlung meist zum Erfolg. Planen Sie bis zu 3 Versuche pro Bild ein (Sie zahlen nur für erfolgreich gerenderte Bilder).

import json, time, requests

API = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": "Bearer YOUR_HIAPI_KEY",
           "Content-Type": "application/json"}

CATALOG = [
    {"sku": "bottle-navy",  "colour": "matte navy blue"},
    {"sku": "bottle-coral", "colour": "matte coral pink"},
    {"sku": "bottle-sage",  "colour": "matte sage green"},
]
TEMPLATE = ("A single insulated stainless steel water bottle in {colour}, "
            "standing on a round travertine stone slab against a soft warm "
            "beige studio background, centered, soft diffused lighting, "
            "minimalist e-commerce product photo, photorealistic")

def render(prompt, seed, retries=3):
    for attempt in range(retries):
        task = requests.post(API, headers=HEADERS, json={
            "model": "flux-1.1-pro",
            "input": {"prompt": prompt, "aspect_ratio": "1:1",
                      "output_format": "jpg", "seed": seed},
        }).json()
        task_id = task["data"]["taskId"]
        while True:
            state = requests.get(f"{API}/{task_id}", headers=HEADERS).json()["data"]
            if state["status"] == "success":
                return requests.get(state["output"][0]["url"]).content
            if state["status"] == "fail":          # transient TASK_FAILED happens;
                break                              # resubmit with the same input
            time.sleep(5)
    raise RuntimeError(f"gave up after {retries} attempts")

for item in CATALOG:
    img = render(TEMPLATE.format(colour=item["colour"]), seed=5150)
    with open(f"{item['sku']}.jpg", "wb") as f:
        f.write(img)                               # re-host immediately; task URLs expire
    print(item["sku"], "done")

Wenn Sie Hunderte von SKUs pushen, drosseln Sie die Übermittlungsrate – Bild-API-Rate-Limits im Detail beschreibt das Drosselungsverhalten und eine sinnvolle Parallelität.

Preise und wann Sie flux-1.1-pro wählen sollten

Verifiziert auf der hiapi-Preisseite:

Modell	Preis pro Bild	Anwendungsfall
`flux-schnell/text-to-image`	0,005 $	Entwürfe, Layout-Kompositionen, große Mengen an Thumbnails
`flux-1.1-pro`	einheitlich 0,05 $	Fotorealistische Freisteller und Lifestyle-Bilder, beliebige Auflösung bis 1440px
`flux-2/text-to-image`	0,0375–0,125 $ (pro MP)	Höchste Prompt-Treue, lesbarer Text im Bild

Der einheitliche Preis ist der unterschätzte Vorteil: Ein 1440×960-Hero-Banner und ein 512×512-Thumbnail kosten beide 0,05 $, während flux-2 pro Megapixel abrechnet. Wenn Ihre Workload „fotorealistische Produktbilder, gemischte Größen“ ist, ist flux-1.1-pro die Standardwahl mit planbaren Kosten; wenn Sie exakte Objektanzahlen oder im Bild lesbaren Drucktext benötigen, upgraden Sie auf flux-2 – wir haben dort dasselbe E-Commerce-Rezept durchlaufen lassen.

Eine fünfteilige PDP (Hauptbild, Freisteller, Lifestyle-Bild, zwei Farbvarianten) summiert sich auf 0,25 $ pro Produkt. Einen Katalog mit 200 SKUs auffrischen: 50 $, ein Nachmittag, ein Skript.

Fazit

flux-1.1-pro auf hiapi liefert Ihnen fotorealistische Produktbilder in einem asynchronen Zwei-Aufruf-Workflow: ein strikter, aber einfacher Parameterbereich (Seitenverhältnis, Größe, Seed, Format – kein Herumfummeln an steps/guidance), Farbvarianten mit festem Seed und ein einheitlicher Preis von 0,05 $, der Katalogbudgets äußerst planbar macht. Holen Sie sich Ihren API-Schlüssel, starten Sie auf der flux-1.1-pro-Modellseite und rendern Sie Ihren ersten Freisteller mit dem obigen curl-Aufruf – Ihr Kaffee ist noch heiß, da haben Sie schon ein bildbereites PDP-Bild.