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.
TL;DR
- Auf HiAPI kostet
recraft-v4.1-flash/text-to-imagenur 0,01 $ pro Bild, sodass 1.000 Katalogbilder 10,00 $ kosten. Die Standardversionrecraft-v4.1/text-to-imagekostet 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_colorauf 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ätzlichbackground_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 →-
Benutzerhandbuch
Was ist GPT Image 2.6? Markup-Bearbeitung und bekannte Spezifikationen
Alle Informationen zu GPT Image 2.6 in der OpenAI-API-Spezifikation, wie man den neuen markup-Bearbeitungsparameter verwendet und was noch nicht bekannt gegeben wurde.
-
Benutzerhandbuch
Was kostet die Vidu Q4 Preview API? 540p pro Sekunde $0.0515
Beide Modi kosten gleich viel: So wird über fünf Auflösungsstufen und 3–16 Sekunden abgerechnet, wie viele Clips $10 ermöglichen und wie der Preis im Vergleich zu anderen Videomodellen im Angebot aussieht.
-
Benutzerhandbuch
Recraft Creative Upscale API Preis: $0.3575 pro Bild
Hochskalierungsbudget pro Bild berechnen, Eingabegrenzen, Anzeigevorschau und vollständiges Ergebnis unterscheiden und die Neuerstellung von Details verstehen.