E-Commerce-Produktbilder mit flux-2-klein-9b/text-to-image über die hiapi API generieren

Die meisten schnellen und günstigen Text-zu-Bild-Modelle zwingen dich zu einer Entscheidung: entweder ist der Text auf dem Bild klar lesbar, oder der Preis ist niedrig. flux-2-klein-9b/text-to-image ist eines der wenigen Modelle in der Kategorie „günstig und schnell“, das dich nicht vor diese Wahl stellt. hiapi versieht es mit den Tags Text Rendering, High Fidelity (Textwiedergabe, hohe Wiedergabetreue) – und in der Praxis bedeutet das, dass es in einer einzigen Generierung Marken-Schriftzüge, eine Zeile mit kleinem Textetikett und eine auffällige große Aktionsüberschrift rendern kann, ohne dass ein zweiter Durchlauf nötig ist, um verunglückte Buchstaben zu korrigieren.

Das ist besonders wichtig für E-Commerce-Produktbilder: Genau die Bilder, die wirklich Text benötigen – Hauptbilder mit sichtbarem Etikett, zeitlich begrenzte Aktionsbanner mit Preisangabe –, sind die, die günstige „schnelle“ Modelle am ehesten verpatzen.

In diesem Artikel werden alle drei Bilder mit flux-2-klein-9b/text-to-image generiert, ohne einen einzigen Wiederholungsversuch: Etikettentext, große Aktionsüberschrift und Rabattzeile waren alle beim ersten Generierungslauf sauber und fehlerfrei. Das heißt nicht, dass dies bei jedem Prompt garantiert ist (siehe die Korrekturhinweise weiter unten), aber für ein Modell dieser Preisklasse ist es ein gutes Zeichen.

Preisgestaltung: flux-2-klein-9b im Vergleich zu flux-2-klein-4b (Text-zu-Bild)

Beide Modelle gehören zur „Klein“-Familie und setzen beide auf Schnelligkeit und niedrige Kosten. Der Unterschied liegt darin, wofür du bezahlst:

Modell	Preis pro Bild	Tags
flux-2-klein-9b/text-to-image	Pauschal $0.00858	Text-to-Image, Text Rendering, High Fidelity
flux-2-klein-4b/text-to-image	Pauschal $0.00143	Text-to-Image, Fast, Cost Efficient

(Preise Stand 2026-08, gegen /api/pricing bestätigt.)

flux-2-klein-4b/text-to-image ist etwa 6-mal günstiger – eine gute Standardwahl für Hintergrundflächen, Lifestyle-Aufnahmen oder jedes Bild, bei dem Text nicht Teil der Komposition ist. Es besitzt jedoch kein Text-Rendering-Tag. Wenn der Text auf Karten, Etiketten oder Bannern tatsächlich klar lesbar sein soll, ist klein-9b trotz des höheren Preises die sicherere Wahl. Und bei einem Preis von unter einem Cent pro Bild ist „sicher“ hier immer noch günstiger als ein einziger API-Aufruf der meisten LLMs.

Eine echte Anfrage

Im Folgenden eine funktionierende Anfrage an den Endpunkt /v1/tasks, um eine Aktionskarte mit gerendertem Text zu erzeugen:

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-2-klein-9b/text-to-image",
    "input": {
      "prompt": "Social-Media-Werbebanner für eine zeitlich begrenzte E-Commerce-Aktion: eine Pipettenflasche aus mattiertem Glas, auf deren Etikett 'VELURA HYDRA SERUM' steht, zentriert auf einem weichen Verlaufs hintergrund von Rouge-Rosa zu Creme, oben eine große, fett gesetzte, saubere serifenlose Überschrift mit dem Inhalt 'FLASH SALE' in dunkel anthrazitfarbenen Buchstaben, darunter eine kleinere Textzeile mit dem Inhalt '30% OFF' in derselben Schriftart, unten rechts ein dünnliniges abgerundetes rechteckiges Badge mit dem Text 'VELURA', klar lesbare Typografie, ausgewogener Weißraum, modernes minimalistisches Marketingdesign, kein weiterer Text, kein Wasserzeichen",
      "aspect_ratio": "1:1"
    }
  }'

Die Anfrage gibt eine taskId zurück. Frage GET /v1/tasks/{taskId} ab, bis status den Wert success hat, und lade dann output[0].url herunter – signierte Links laufen ab, also hole die Bytes sofort und speichere sie selbst.

Schema-Hinweise: Was tatsächlich funktioniert

Bevor du auf Basis dieses Modells entwickelst, lohnt es sich, einige Punkte zu kennen, die auf dem basieren, was die API tatsächlich akzeptiert (und nicht nur auf der Dokumentation):

• resolution wird abgelehnt. Anders als bei einigen anderen hiapi-Bildmodellen führt das Senden des Feldes resolution zu einem 400 (additional properties not allowed). Sende nur aspect_ratio.
• aspect_ratio ist eine feste kurze Liste: 1:1, 4:3, 3:4, 16:9, 9:16. Es gibt kein 4:5 oder 21:9 – wenn dein Layout einen höheren Hochformat-Zuschnitt wünscht, ist 3:4 das nächstliegende unterstützte Verhältnis (dies haben wir für die Lifestyle-Aufnahme weiter unten verwendet).
• aspect_ratio ist selbst optional. Lässt du es ganz weg, wird trotzdem ein gültiges Bild erzeugt, und zwar mit dem serverseitigen Standardwert – aber in der E-Commerce-Arbeit willst du fast immer ein festes Format (quadratisch für Feed-Posts, 16:9 für Hauptbanner), daher lohnt es sich, es explizit zu setzen, statt sich auf den Standardwert zu verlassen.
• Pauschaler Preis pro Bild, keine Auflösungsstufen. Anders als flux-2-klein-4b/image-to-image (fünf Preisstufen nach Megapixeln) hat klein-9b/text-to-image unabhängig vom Seitenverhältnis einen einheitlichen Pauschalpreis.

Prompt + Ausgabe: Hauptbild

Prompt (16:9, unverändert verwendet, nach der Generierung nicht bearbeitet):

E-Commerce-Produkthauptbild: eine Pipettenflasche aus mattiertem Glas, gefüllt mit hochwertigem Hautpflege-Serum, steht auf einer feuchten grauen Marmorplatte, weiches Tageslicht von links wirft einen sanften Schatten, minimalistischer beigefarbener Hintergrund, kleine Wassertropfen auf dem Marmor, auf dem Etikett der Flasche steht klar lesbar 'VELURA' in einer sauberen modernen Serifenschrift, darunter der kleinere Text 'HYDRA SERUM', professionelle Studio-Produktfotografie, scharfer Fokus, subtiles Konturlicht, kein weiterer Text, keine Hände, kein Logo-Wasserzeichen

(Das Bild ist oben in diesem Artikel zu sehen.) Markenname und Produktlinie werden in normalem Leseabstand sauber gerendert – keine doppelten Buchstaben, keine verschmolzenen Serifen, was genau das übliche Fehlermuster günstiger Text-zu-Bild-Modelle dieser Preisklasse ist.

Prompt + Ausgabe: Lifestyle-Aufnahme

Prompt (3:4):

Lifestyle-E-Commerce-Foto: eine Pipettenflasche aus mattiertem Glas mit der Aufschrift 'VELURA HYDRA SERUM' auf dem Etikett, auf einer hellen Badezimmerablage stehend, daneben ein gefaltetes weißes Handtuch und ein kleiner Zweig einer getopften Eukalyptuspflanze, warmes Morgenlicht fällt durch ein Fenster, weiche Schatten, geringe Schärfentiefe, natürlich-lässige Anordnung, der Etikettentext 'VELURA' und 'HYDRA SERUM' auf der Flasche bleibt scharf und klar lesbar, keine Personen, keine Hände, keine zusätzlichen Textüberlagerungen

Lifestyle-Aufnahmen wie diese benötigen in der Regel überhaupt keinen Text im Bild – aber das Etikett muss unter weicherem, diffuserem Licht als beim Studio-Hauptbild standhalten, und das ist ein schwierigerer Test für die Texttreue des Modells.

Prompt + Ausgabe: Aktionskarte

Prompt (1:1):

Social-Media-Werbebanner für eine zeitlich begrenzte E-Commerce-Aktion: eine Pipettenflasche aus mattiertem Glas mit der Aufschrift 'VELURA HYDRA SERUM' auf dem Etikett, zentriert auf einem weichen Verlaufs hintergrund von Rouge-Rosa zu Creme, oben eine große, fett gesetzte, saubere serifenlose Überschrift mit dem Inhalt 'FLASH SALE' in dunkel anthrazitfarbenen Buchstaben, darunter eine kleinere Textzeile mit dem Inhalt '30% OFF' in derselben Schriftart, unten rechts ein dünnliniges abgerundetes rechteckiges Badge mit dem Text 'VELURA', klar lesbare Typografie, ausgewogener Weißraum, modernes minimalistisches Marketingdesign, kein weiterer Text, kein Wasserzeichen

Dies ist das Bild, das das Tag „Text Rendering, High Fidelity“ des Modells wirklich auf die Probe stellt: zwei Zeilen großer Überschriftentext plus ein kleiner Badge-Text, alles in einer einzigen Generierung. Jedes Wort ist korrekt geschrieben und die Laufweite bleibt stimmig – aber gerade deshalb solltest du es vor der Veröffentlichung trotzdem persönlich prüfen (siehe unten).

Das Korrekturlesen nicht überspringen

Die eigenen Inhaltsrichtlinien von hiapi sagen es ganz offen: KI-Textwiedergabe ist „99 %, nicht 100 %“. Selbst Modelle mit dem Tag für hochgetreue Textwiedergabe schreiben gelegentlich ein Wort falsch, lassen einen Buchstaben aus oder quetschen zwei Wörter zusammen – besonders bei kleinem Etikettentext im Vergleich zu großer Überschrift (kleiner Text ist schwieriger). Bevor du generierte Aktionskarten oder Produktetiketten veröffentlichst:

1. Zoome jede gerenderte Textzeile bei 100 % heran und prüfe sie.
2. Prüfe Rechtschreibung und Abstände, nicht nur, ob es „wie Text aussieht“.
3. Wenn etwas nicht stimmt, generiere neu – korrigiere nicht manuell die Pixel, denn ein erneuter Lauf kostet nur einen Bruchteil eines Cents.
4. Bei Text, der sich häufig ändert (Preise, Aktionsdaten), erwäge, ihn in deinem eigenen Template-Schritt zu überlagern, statt ihn in jede Generierung einzubrennen – das ist günstiger zu aktualisieren und schließt das Risiko eines erneuten Laufs vollständig aus.

Stapelgenerierung mit Python

Für einen vollständigen Produktkatalog packst du dasselbe Anfragemuster in eine Schleife:

import requests
import time

API_KEY = "your-api-key"
BASE = "https://api.hiapi.ai/v1/tasks"

def generate(prompt, aspect_ratio="1:1"):
    resp = requests.post(
        BASE,
        headers={"Authorization": f"Bearer {API_KEY}"},
        json={
            "model": "flux-2-klein-9b/text-to-image",
            "input": {"prompt": prompt, "aspect_ratio": aspect_ratio},
        },
    )
    task_id = resp.json()["data"]["taskId"]

    while True:
        task = requests.get(
            f"{BASE}/{task_id}",
            headers={"Authorization": f"Bearer {API_KEY}"},
        ).json()["data"]
        if task["status"] == "success":
            return task["output"][0]["url"]
        if task["status"] == "fail":
            raise RuntimeError(task["error"])
        time.sleep(5)

prompts = [
    ("Hero shot for product SKU-001, studio lighting, label reads 'BRAND NAME'", "16:9"),
    ("Lifestyle shot for product SKU-001 on a wooden shelf", "3:4"),
    ("Flash sale card for product SKU-001, headline 'LIMITED TIME'", "1:1"),
]

for prompt, ratio in prompts:
    url = generate(prompt, ratio)
    print(url)  # download immediately — the URL expires

Bei $0.00858 pro Bild kostet ein Produktkatalog mit 50 SKUs und 3 Bildern pro SKU (Hauptbild, Lifestyle-Aufnahme, Aktionsbild) insgesamt etwa $1.29 – im Vergleich zu einem freiberuflichen Produktfotoshooting ist das praktisch ein Taschengeld.

flux-2-klein-9b/text-to-image im Vergleich zu verwandten Workflows

Wenn du auf hiapi eine umfassendere Produktbild-Pipeline aufbaust, lohnt sich als Nächstes die Lektüre einiger verwandter Teile:

• Wenn du bestehende Produktfotos bearbeiten oder umstilisieren willst, statt von Grund auf neu zu generieren, siehe flux-2-klein-4b für Bild-zu-Bild-E-Commerce-Retusche – das ist eine andere Aufgabe (i2i statt t2i), die dafür gebaut ist, echte Fotos aufzubereiten, statt neue Szenen zu erzeugen.
• Zu Prompt-Mustern, die für den Bild-zu-Bild-Modus der 9b-Klasse typisch sind (dieselbe Textwiedergabestärke, angewendet auf Bearbeitung), siehe flux-2-klein-9b Bild-zu-Bild-Prompts.
• Vollständige Parameter, Live-Preise und eine Konsole zum Testen von Prompts vor dem Stapellauf: Modellseite von flux-2-klein-9b/text-to-image.

FAQ

Unterstützt flux-2-klein-9b/text-to-image Bild-zu-Bild? Nein – dieser spezifische Endpunkt unterstützt nur Text-zu-Bild. hiapi listet separat ein Modell flux-2-klein-9b/image-to-image (Preis $0.03143/Bild) zum Bearbeiten bestehender Fotos.

Welche Seitenverhältnisse werden unterstützt? Fünf: 1:1, 4:3, 3:4, 16:9, 9:16. Es gibt kein natives 4:5 – verwende 3:4 für einen ähnlichen Hochformat-Zuschnitt.

Kann ich die Ausgabeauflösung festlegen? Nein. Das Senden des Feldes resolution führt zu einem 400. Preis und Ausgabegröße sind je nach Seitenverhältnis fest.

Wäre flux-2-klein-4b günstiger? Ja, etwa 6-mal günstiger pro Bild ($0.00143 gegenüber $0.00858) – aber klein-4b hat kein Text-Rendering-Tag. Verwende es für Bilder ohne Text (reine Lifestyle- oder Hintergrundbilder) und überlasse klein-9b alle Bilder mit Etiketten, Überschriften oder Preisangaben.

Wie lange dauert die Generierung? Alle drei Bilder in diesem Artikel waren über den Polling-Ablauf von /v1/tasks jeweils in unter zwei Minuten fertig.

Ausprobieren

Du kannst flux-2-klein-9b/text-to-image direkt auf der Modellseite mit deinen eigenen Prompts testen, bevor du es in Stapelaufgaben einbindest; die aktuellen Tarife findest du jederzeit auf der Preisseite. Das vollständige Anfrage-/Antwort-Schema und die Authentifizierungseinrichtung findest du in der API-Dokumentation.