E-Commerce-Produktbilder mit seedream-4.5/text-to-image über die hiapi API generieren

Nicht jedes Produktbild beginnt mit einem Foto. Bevor ein Muster existiert, bevor ein Fotograf gebucht ist, oder wenn eine saisonale Aktion bis morgen früh ein Banner braucht, müssen Sie Bilder allein aus einer Textbeschreibung erzeugen – ein sauberes Produkt-Rendering, eine Lifestyle-Szene, eine Werbegrafik mit echtem, klar lesbarem Titeltext.

seedream-4.5/text-to-image ist genau für dieses Zero-Shot-Szenario gemacht. Geben Sie ihm eine Beschreibung in natürlicher Sprache, und es liefert ein fotorealistisches Bild zurück – ganz ohne Referenzfoto – einschließlich korrektem Text im Bild, was bei den meisten Text-zu-Bild-Modellen immer noch schiefgeht. Auf hiapi läuft es wie alle anderen Modelle über denselben asynchronen /v1/tasks-Endpunkt, zum Preis von 0,045 $ pro Bild, in einer Auflösung von 2K oder 4K.

Die beiden folgenden Beispiele sind echte API-Aufrufe, die ihre exakten Prompts und die generierten Bilder zeigen – ohne jede Nachbearbeitung.

Zero-Shot-Generierung versus Bearbeitung echter Fotos

seedream-4.5 erscheint als zwei Modelle mit unterschiedlichen Aufgaben:

• seedream-4.5/text-to-image (Thema dieses Artikels) erzeugt Bilder aus einer Beschreibung, ohne Eingabefoto. Verwenden Sie es, wenn das Produkt noch kein sauberes Referenzfoto hat, wenn Sie eine Szene oder ein Konzept benötigen, die es im Katalog nicht gibt, oder wenn das Ergebnis Marketing-Artwork ist statt eines Fotos eines konkreten physischen Produkts.
• seedream-4.5/image-to-image bearbeitet ein echtes Produktfoto, das Sie bereits haben, bewahrt dessen exakte Form und Markenidentität und ändert dabei Hintergrund oder Kontext – für diesen Workflow lesen Sie den Leitfaden zu Image-to-Image im E-Commerce.

Wenn Sie pixelgenaue Übereinstimmung mit einer konkreten SKU brauchen, nutzen Sie das Bearbeitungsmodell. Wenn Sie etwas völlig Neues erzeugen wollen – ein Konzept-Rendering, ein saisonales Banner, eine Szene, die es noch nicht gibt –, ist Text-to-Image das richtige Werkzeug und der Inhalt dieses Artikels.

Beispiel 1: ein Studio-Produktbild aus Text

An das Modell gesendeter Prompt:

a minimalist amber glass skincare serum bottle with a brushed silver cap
standing on a polished travertine surface, soft diffused window light
casting a gentle gradient shadow, sage green linen backdrop, one small
dried eucalyptus sprig beside the bottle, e-commerce product photography,
sharp focus, clean composition, no text, no logo, subtle reflection on
the stone surface

Anfrageparameter: aspect_ratio: "1:1", resolution: "2K".

Hier gibt es keine Flasche, kein Studio und keinen Fotografen – der weiche Schattenverlauf, die Reflexion auf dem Stein und das sanfte Fensterlicht stammen vollständig aus der Beschreibung. Genau darin liegt der Vorteil von Text-to-Image gegenüber der Bearbeitung: ein Listing-Rendering oder Moodboard für ein Produkt, das sich noch in Entwicklung befindet, in etwa einer Minute statt mit einem angesetzten Shooting.

Beispiel 2: Werbegrafiken mit echtem, klar lesbarem Titeltext

Textdarstellung ist die schwierigere Hälfte dieser Aufgabe – die meisten Bildgeneratoren erzeugen Kauderwelsch oder falsch geschriebenen Text. Zwei Prompts, beide ohne Wiederholung:

Flach liegendes Aktionsbanner:

a flat-lay e-commerce marketing banner for a summer skincare sale, an
arrangement of amber glass bottles and dried botanicals on a warm
terracotta background, bold sans-serif headline text 'SUMMER GLOW SALE'
near the top in cream white lettering, smaller text 'Up to 30% Off'
beneath it in matching cream, clean modern layout with generous negative
space on the right third, professional marketing design, crisp legible
typography, warm cinematic lighting

Anfrageparameter: aspect_ratio: "4:3", resolution: "2K".

Vertikale Story-Grafik:

a vertical social media story graphic for a candle brand product launch,
a single black matte ceramic candle jar centered on a deep charcoal
gradient background, bold white headline text 'NEW ARRIVAL' near the
top, smaller subtext 'Shop the Collection' below the product, minimalist
premium aesthetic, soft rim lighting on the candle jar, generous margin
for mobile screen safe zones

Anfrageparameter: aspect_ratio: "9:16", resolution: "2K".

Beide Überschriften und beide Unterzeilen sind korrekt geschrieben, gleichmäßig gesperrt und sitzen genau dort, wo der Prompt es verlangt – beim ersten Generierungsversuch, ohne Wiederholung. Diese Zuverlässigkeit macht Text-to-Image für Werbematerial unter engen Terminen nutzbar: ein Aktionsbanner oder eine Story-Grafik, die sonst ein Designer anfertigen müsste, ist jetzt mit einem einzigen API-Aufruf entworfen.

Die API direkt aufrufen

seedream-4.5/text-to-image läuft über den asynchronen Aufgaben-Endpunkt von hiapi: Aufgabe absenden, bis zum Abschluss abfragen, dann das Ergebnis herunterladen.

curl:

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-4.5/text-to-image",
    "input": {
      "prompt": "a minimalist amber glass skincare serum bottle on a travertine surface, soft window light, sage linen backdrop, e-commerce product photography, no text",
      "aspect_ratio": "1:1",
      "resolution": "2K"
    }
  }'

Die Antwort liefert eine task_id. Fragen Sie GET /v1/tasks/{task_id} ab, bis status den Wert succeeded hat, und lesen Sie dann das Bild aus output[0].url. Die URL ist zeitlich begrenzt – laden Sie sofort herunter.

Python (Aufgabe absenden + abfragen + herunterladen):

import os
import time
import requests

API_BASE = "https://api.hiapi.ai/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"}


def generate_product_image(prompt: str, aspect_ratio: str = "1:1",
                            resolution: str = "2K") -> bytes:
    resp = requests.post(
        f"{API_BASE}/tasks",
        headers=HEADERS,
        json={
            "model": "seedream-4.5/text-to-image",
            "input": {
                "prompt": prompt,
                "aspect_ratio": aspect_ratio,
                "resolution": resolution,
            },
        },
        timeout=30,
    )
    resp.raise_for_status()
    task_id = resp.json()["task_id"]

    while True:
        poll = requests.get(f"{API_BASE}/tasks/{task_id}", headers=HEADERS, timeout=30)
        poll.raise_for_status()
        data = poll.json()
        if data["status"] == "succeeded":
            image_url = data["output"][0]["url"]
            return requests.get(image_url, timeout=30).content
        if data["status"] == "failed":
            raise RuntimeError(f"task {task_id} failed: {data.get('error')}")
        time.sleep(3)

Eine ganze Produktlinie im Batch generieren

Derselbe Aufruf lässt sich auf eine komplette Produktlinie übertragen: eine Liste von (name, prompt, aspect_ratio)-Tupeln, ein Task pro Eintrag, und die Speicherung auf die Festplatte nach Namen.

JOBS = [
    {
        "name": "serum-hero",
        "prompt": "a minimalist amber glass skincare serum bottle on a travertine "
                   "surface, soft window light, sage linen backdrop, e-commerce "
                   "product photography, no text",
        "aspect_ratio": "1:1",
    },
    {
        "name": "sale-banner",
        "prompt": "a flat-lay e-commerce marketing banner for a summer skincare "
                   "sale, amber glass bottles on a terracotta background, bold "
                   "headline text 'SUMMER GLOW SALE', smaller text 'Up to 30% Off'",
        "aspect_ratio": "4:3",
    },
    {
        "name": "story-launch",
        "prompt": "a vertical social story graphic, a black matte ceramic candle "
                   "jar on a charcoal gradient background, bold white headline "
                   "'NEW ARRIVAL', subtext 'Shop the Collection'",
        "aspect_ratio": "9:16",
    },
]

for job in JOBS:
    image_bytes = generate_product_image(
        prompt=job["prompt"],
        aspect_ratio=job["aspect_ratio"],
        resolution="2K",
    )
    with open(f"{job['name']}.jpg", "wb") as f:
        f.write(image_bytes)
    print(f"{job['name']}: done")

Bei 0,045 $ pro Bild kostet ein saisonaler Launch mit 20 Assets – Hero-Bilder, Banner und Story-Grafiken zusammen – etwa 0,90 $. Da jeder Task unabhängig ist, ist das gleichzeitige Absenden mehrerer /v1/tasks-Aufrufe mit paralleler Abfrage (unter Beachtung der Rate-Limits Ihres Kontos) schneller als das sequenzielle Durchlaufen der Liste.

Vergleich mit seedream-5.0-pro

hiapi betreibt außerdem seedream-5.0-pro als eigenständige, neuere Stufe für Text-to-Image-Arbeit im E-Commerce. Beide sind nicht dasselbe Modell: Preisgestaltung, Auflösungsoptionen und Ausgabeeigenschaften unterscheiden sich, und der Workflow von seedream-5.0-pro wird in seinem eigenen Leitfaden behandelt. Wenn das Ergebnis zuverlässigen Text im Bild benötigt – Aktionsbanner, Story-Grafiken, Aktionskarten – und Sie einen festen Preis von 0,045 $ pro Bild wünschen, ohne die Preisstufung nach Auflösung einplanen zu müssen, ist seedream-4.5/text-to-image genau das richtige Modell.

Häufig gestellte Fragen

Akzeptiert seedream-4.5/text-to-image Referenzfotos? Nein – text-to-image akzeptiert nur prompt, aspect_ratio und resolution. Um ein vorhandenes Produktfoto zu bearbeiten statt ein neues Bild zu erzeugen, verwenden Sie seedream-4.5/image-to-image.

Welche Auflösungen und Seitenverhältnisse werden unterstützt? resolution akzeptiert nur 2K oder 4K – es gibt keine 1K-Stufe. aspect_ratio akzeptiert 1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2 und 21:9.

Kann es Überschriftentext zuverlässig im Bild darstellen? Ja – beide Werbebeispiele oben haben mehrteilige Überschriften und Unterzeilen beim ersten Generierungsversuch korrekt dargestellt, ohne Rechtschreibfehler und ohne verzerrte Glyphen.

Was kostet die Batch-Generierung einer Produktlinie? Unabhängig von der Auflösungsstufe 0,045 $ pro Bild. Ein saisonales Set aus 20 Bildern kostet etwa 0,90 $; ein Set aus 100 Bildern etwa 4,50 $.

Kann ich Generierungen parallel ausführen, um Batch-Aufgaben zu beschleunigen? Ja – jeder Task ist unabhängig, daher ist das gleichzeitige Absenden mehrerer /v1/tasks-Aufrufe mit paralleler Abfrage der schnellste Weg, große Mengen an Assets zu erzeugen.

Selbst ausprobieren

Die vollständige Parameterreferenz und die aktuellen Preise finden Sie auf der Modellseite und der Preisseite. Weitere Prompt-Muster für dieses Modell finden Sie in den Prompt-Rezepten für seedream-4.5 Text-to-Image. Wenn Ihr Workflow mit echten Produktfotos statt mit einem leeren Blatt beginnt, behandelt der Leitfaden zu Image-to-Image im E-Commerce mit seedream-4.5 die direkte Bearbeitung.

Holen Sie sich einen API-Schlüssel und generieren Sie Ihr erstes Produktbild oder Aktionsbanner – der obige Code lässt sich heute kopieren und direkt gegen die hiapi API ausführen.