HiAPI
Blog

Benutzerhandbuch

Recraft V4.1 Flash E-Commerce-Produktbilder: Katalogbilder in Massenfertigung für je 0,01 $

Ein echter paralleler Batch auf recraft-v4.1-flash/text-to-image: Produktlisten- und Szenenbilder, gemessene Hintergrundweiße, Laufzeit und Batch-Skript.

Nov 1, 2026
Recraft V4.1 Flash E-Commerce-Produktbilder: Katalogbilder in Massenfertigung für je 0,01 $

TL;DR

  • Auf HiAPI kostet recraft-v4.1-flash/text-to-image nur 0,01 $ pro Bild, sodass 1.000 Katalogbilder 10,00 $ kosten. Die Standardversion recraft-v4.1/text-to-image kostet 0,05 $ pro Bild und akzeptiert dieselben Parameter (Preisvergleich).
  • In unserem Lauf wurden 4 parallel übermittelte Produktbilder in 21,5 Sekunden tatsächlicher Laufzeit fertiggestellt, wobei jeder Task (inklusive Download) etwa 19–20 Sekunden benötigte. Gesamtkosten: 0,04 $.
  • Wird background_color auf Weiß gesetzt, ist der erzeugte Hintergrund nahezu weiß, aber nicht einheitlich #FFFFFF. Wenn der Marktplatz reines Weiß verlangt, ist ein zusätzlicher Bereinigungsschritt nötig.

Wann Sie für Kataloge die Flash-Stufe wählen sollten

Verwenden Sie Flash, wenn das Volumen groß ist: Jede SKU benötigt ein Produktlistenbild auf weißem Grund plus ein bis zwei Szenenbilder, und Sie planen, vor der Veröffentlichung jedes einzeln zu prüfen. Bei 0,01 $ pro Bild kosten 500 SKUs mit je 3 Bildern insgesamt 15,00 $. Dieselben 1.500 Bilder kosten mit der Standardversion V4.1 75,00 $.

Flash und die Standardversion V4.1 akzeptieren dieselben Eingabefelder, daher genügt zum Upgrade ausgewählter Bilder auf die höhere Stufe eine Änderung von model. Dieser Artikel vergleicht die Bildqualität der beiden Stufen nicht, da wir sie nicht mit identischen Prompts separat ausgeführt haben. Prüfen Sie die Ausgaben selbst, bevor Sie die Stufe für Produktionsmaterial festlegen.

Verifiziertes Eingabe-Schema

Wir haben das Schema anhand der Live-API überprüft, indem wir absichtlich ungültige Werte gesendet haben:

Feld Typ Hinweis
prompt string (Zeichenkette) erforderlich
image_size enum (Aufzählung) square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
colors {r,g,b}-Array Palettenführung. Die Übergabe einer Zeichenkette gibt 400 INVALID_REQUEST: colors: got string, want array zurück
background_color {r,g,b} Hintergrundfarbe

Unbekannte Felder werden abgelehnt (additional properties ... not allowed), ebenso jede image_size außerhalb der sechs Presets. Benutzerdefinierte Pixelgrößen werden nicht unterstützt. Die von uns erhaltenen Größen: square_hd 1024×1024, portrait_4_3 896×1216, landscape_4_3 1216×896.

Echte Ausgaben aus einem Batch

Die folgenden vier Bilder stammen alle aus demselben parallelen Batch. Die Bildunterschriften geben die Abmessungen an; jedes Bild kostet 0,01 $.

Produktlistenbild auf weißem Grund

E-Commerce-Produktfoto einer matten, salbeigrünen Keramik-Kaffeetasse mit geschwungenem Griff, zentriert, frontale Dreiviertelansicht, reinweißer nahtloser Hintergrund, weiches gleichmäßiges Studiolicht, sanfter Kontaktschatten, keine Requisiten, kein Text

recraft-v4.1-flash/text-to-image, square_hd, 1024×1024, background_color Weiß, 0,01 $.

E-Commerce-Produktfoto eines einzelnen weißen Low-Top-Sneakers aus Leder mit Gummisohle, Seitenprofil nach links, reinweißer nahtloser Hintergrund, weiches gleichmäßiges Studiolicht, dezenter Schatten unter der Sohle, keine Requisiten, kein Text

recraft-v4.1-flash/text-to-image, square_hd, 1024×1024, background_color Weiß, 0,01 $.

Die Tasse entspricht dem Prompt weitgehend: zentriert, sauberer Kontaktschatten, keine Requisiten. Der Sneaker zeigt, warum dennoch eine Prüfung nötig ist. Wir hatten eine Gummisohle (gum rubber sole) verlangt, erhielten aber eine cremefarbene Sohle, und der Schuh sitzt in der unteren Bildhälfte statt zentriert. Ohne Abgleich mit dem echten Produkt taugen beide Bilder nicht als brauchbares Produktlistenbild für eine echte SKU.

Lifestyle-Szenenbilder

Lifestyle-Produktfoto einer bernsteinfarbenen Serum-Dropperflasche aus Glas mit schlichtem weißen Etikett, stehend auf einer Travertinstein-Ablage neben einem Eukalyptuszweig, Badezimmerregal, weiches Morgenfensterlicht, geringe Schärfentiefe, hochwertiger Kosmetikkatalog-Look

recraft-v4.1-flash/text-to-image, portrait_4_3, 896×1216, 0,01 $.

Lifestyle-Produktfoto eines anthrazitfarbenen Rolltop-Rucksacks aus Canvas, gelehnt an eine Holzbank in einem sonnendurchfluteten Bahnhof, warmes Nachmittagslicht, geringe Schärfentiefe, Reisekatalog-Look, keine Menschen, keine Logos

recraft-v4.1-flash/text-to-image, landscape_4_3, 1216×896, 0,01 $.

Beide Szenen enthalten alle Requisiten- und Lichtvorgaben ihrer jeweiligen Prompts. Das Etikett der Serumflasche ist wie gewünscht leer. Das ist nützlich, wenn Sie später ein echtes Etikett einfügen möchten, und sicherer, als das Modell eigenen Text erfinden zu lassen.

Was „weißer Hintergrund“ tatsächlich zurückgibt

Wir haben Pixel aus beiden Produktlistenbildern abgetastet:

Bild Ecken-/Randstichprobe (RGB) Exakt 255,255,255 Nahezu weiß (alle Kanäle ≥ 250)
Tasse 255,255,255 · 255,255,253 · 253,254,252 48,1 % der Pixel 75,4 %
Sneaker 254,253,253 · 251,250,249 · 255,255,255 58,3 % der Pixel 79,3 %

Der Hintergrund wirkt weiß, ist aber kein flächiges #FFFFFF. Marktplätze, die ein reines Weiß für das Hauptbild verlangen, benötigen einen Nachbearbeitungsschritt. Sie können nahezu weiße Pixel auf 255 begrenzen oder das Produkt freistellen und auf eine saubere Leinwand setzen. Das Recraft-Tutorial zur Hintergrundentfernung beschreibt eine Freistellungslösung auf derselben API.

Batch-Skript: paralleles Übermitteln, Abfragen, Herunterladen

Dies ist das Skript, das wir ausgeführt haben, in gekürzter Form. Jede SKU hat ihren eigenen Idempotency-Key, sodass Wiederholungen nach Netzwerk-Timeouts keine doppelten kostenpflichtigen Tasks erzeugen. Ausgabe-URLs sind temporär: Unsere URLs lagen auf temp.hiapi.ai und enthielten ein expireAt, das genau 7 Tage nach der Erstellung ablief. Laden Sie jedes Bild so bald wie möglich nach erfolgreichem Abschluss des Tasks herunter.

import os, time, requests
from concurrent.futures import ThreadPoolExecutor

BASE = "https://api.hiapi.ai/v1/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}",
           "Content-Type": "application/json"}
WHITE = {"r": 255, "g": 255, "b": 255}
BATCH_ID = "catalog-2026-11-01"  # change per intentional new batch

JOBS = [
    {"sku": "mug-sage", "image_size": "square_hd", "background_color": WHITE,
     "prompt": "E-Commerce-Produktfoto einer matten, salbeigrünen Keramik-Kaffeetasse ..."},
    {"sku": "serum-amber", "image_size": "portrait_4_3",
     "prompt": "Lifestyle-Produktfoto einer bernsteinfarbenen Serum-Dropperflasche aus Glas ..."},
    # one dict per SKU / shot
]

def run(job):
    payload = {"model": "recraft-v4.1-flash/text-to-image",
               "input": {k: v for k, v in job.items() if k != "sku"}}
    r = requests.post(BASE, json=payload, timeout=60,
                      headers={**HEADERS, "Idempotency-Key": f"{BATCH_ID}-{job['sku']}"})
    r.raise_for_status()
    task_id = r.json()["data"]["taskId"]
    while True:
        task = requests.get(f"{BASE}/{task_id}", headers=HEADERS, timeout=30).json()["data"]
        if task["status"] in ("success", "fail", "failed"):
            break
        time.sleep(3)
    if task["status"] != "success":
        return job["sku"], task["status"]
    img = requests.get(task["output"][0]["url"], timeout=60).content
    with open(f"{job['sku']}.webp", "wb") as f:  # output was WebP in our run
        f.write(img)
    return job["sku"], "saved"

with ThreadPoolExecutor(max_workers=4) as pool:
    for sku, status in pool.map(run, JOBS):
        print(sku, status)

Unser Lauf gab für jeden Task Folgendes zurück (nur einer dargestellt):

{
  "taskId": "tk-hiapi-01M6AMTSX0B7Z531QT740DS54P",
  "model": "recraft-v4.1-flash/text-to-image",
  "status": "success",
  "storage": "temp",
  "output": [{"type": "image", "url": "https://temp.hiapi.ai/.../...-0.webp", "expireAt": 1794111048}]
}

Bei diesem Task lagen die Zeitstempel created und completed 9 Sekunden auseinander. Die restliche Zeit auf Clientseite entfiel auf das Abfrageintervall und das Herunterladen der WebP-Dateien mit 0,45–1,26 MB. Vollständige Details zu Anfragen und Abfragen finden Sie im Recraft V4.1 API-Leitfaden und in der HiAPI-Dokumentation.

Katalogbudget

Bilder pro SKU 100 SKUs 1.000 SKUs
1 (nur Produktlistenbild) 1,00 $ 10,00 $
3 (Produktlistenbild + 2 Szenenbilder) 3,00 $ 30,00 $
3 + 2 Neugenerierungen 5,00 $ 50,00 $

Basierend auf 0,01 $ pro Bild für Flash, verglichen mit der HiAPI-Preisgestaltung vom 1. November 2026. Neugenerierungen werden wie jedes andere Bild abgerechnet, daher sollten Sie einen Teil des Budgets dafür einplanen.

Prompt-Muster für Produktlistenbilder

  • Beginnen Sie mit der Aufnahmeart (E-Commerce-Produktfoto von ...), dann Material + Farbe + Produkt.
  • Legen Sie den Kamerawinkel fest (frontale Dreiviertelansicht, Seitenprofil nach links).
  • Nennen Sie Hintergrund und Beleuchtung ausdrücklich (reinweißer nahtloser Hintergrund, weiches gleichmäßiges Studiolicht) und übergeben Sie zusätzlich background_color.
  • Schließen Sie mit Ausschlüssen ab: keine Requisiten, kein Text.
  • Prüfen Sie produktspezifische Details am realen Artikel. Die Sohlenfarbe des Sneakers zeigt, dass das Modell bei solchen Details abweichen kann.

Häufige Fragen

Reicht Flash für Haupt-Produktlistenbilder? Bei einfachen Produkten wie der Tasse ist die Ausgabe sauber. Details können jedoch abweichen (etwa die Sneaker-Sohle), und der Hintergrund ist kein reines #FFFFFF. Prüfen Sie jedes Bild und bereinigen Sie den Hintergrund, falls der Marktplatz es verlangt.

Kann ich Markenfarben über einen Batch hinweg konsistent halten? Ja. Übergeben Sie in jeder Anfrage dasselbe colors-Array. Es führt die Palette, ist aber keine pixelgenaue Farbsperre.

Wie upgrade ich ausgewählte Bilder auf die Standardversion V4.1? Senden Sie dieselbe Nutzlast erneut und setzen Sie model auf recraft-v4.1/text-to-image, 0,05 $ pro Bild.

Erzeugt das mein tatsächliches Produkt? Nein. Text-to-Image erzeugt ein Produkt, das Ihrer Beschreibung entspricht. Um den echten Artikel zu zeigen, verwenden Sie die generierte Szene als Hintergrund oder Mockup oder wechseln Sie zu einem Image-to-Image-Workflow.

Bereit, Ihren Katalog zu entwerfen? Öffnen Sie die Recraft V4.1 Flash-Modellseite, testen Sie zunächst einen Produktlisten-Prompt und führen Sie dann das Batch-Skript für die übrigen SKUs aus.

Ähnliche Artikel

Alle Artikel ansehen →

Starte mit persistenten KI-Artefakten

Hol dir deinen API-Key und rufe Bild-, Video- und Audiomodelle über eine einzige task-basierte API auf.

API-Dokumentation lesen