Seedream 5.0 Lite API-Leitfaden: Text-zu-Bild und Bildbearbeitung

Zusammenfassung

• Seedream 5.0 Lite ist ein Bildmodell von ByteDance. Auf HiAPI gibt es zwei Endpunkte: seedream-5.0-lite/text-to-image und seedream-5.0-lite/image-to-image, beide zu $0.035 pro Bild, 2K oder 4K zum selben Preis.
• Es zeichnet sich durch präzise Textdarstellung im Bild aus und eignet sich für gezielte Bearbeitungen: ein einzelnes Objekt ändern, Text auf einem Schild ersetzen oder bis zu 14 Referenzbilder kombinieren, während der Rest der Szene unverändert bleibt.
• Bei jedem Aufruf müssen aspect_ratio und resolution angegeben werden. Öffnen Sie die Modellseite für Text-zu-Bild, um es auszuprobieren; neue Konten erhalten 200 kostenlose Credits.

Text-zu-Bild oder Bild-zu-Bild

	Text-zu-Bild	Bild-zu-Bild
Modell-ID	seedream-5.0-lite/text-to-image	seedream-5.0-lite/image-to-image
Pflichtfelder	prompt, aspect_ratio, resolution	Wie oben, zusätzlich image_urls (1–14)
Preis	$0.035 pro Bild	$0.035 pro Bild, unabhängig von der Anzahl der Referenzbilder
Typische Anwendungsfälle	Poster, Speisekarten, Verpackungen, Infografiken	Farbänderung, Textersetzung, Produktmontage in eine Szene

Live-Preise von HiAPI, verifiziert am 19. Oktober 2026. Fehlgeschlagene Aufgaben werden nicht berechnet.

4K kostet dasselbe wie 2K, daher können Sie für Druckgrößen direkt 4K anfordern. Für etwa $1 lassen sich rund 28 Bilder erzeugen.

Text-zu-Bild: exakte Textwiedergabe

Setzen Sie jedes Wort, das gerendert werden soll, in Anführungszeichen und geben Sie für jede Zeichenkette eine Position an:

Ein handgezeichnetes Poster im Siebdruckstil für ein fiktives Nachtmarkt-Food-Festival, oben ein großer chinesischer Kalligrafie-Titel „夜市食堂“, direkt darunter der englische Untertitel „NIGHT MARKET CANTEEN“ in einer schmalen serifenlosen Schrift, unten eine Datumszeile „OCT 17-19 · RIVERSIDE PIER“, warmer Laternenschein über dicht gedrängten Imbissständen, Dampf steigt aus Bambuskörben auf, begrenzte Farbpalette aus Zinnoberrot, Creme und Tintenblau, sichtbare Druckkörnung, Vintage-Poster-Komposition

Dieses Poster generieren →

seedream-5.0-lite/text-to-image, 2K, $0.035.

Der chinesische Titel, der englische Untertitel und die Datumszeile werden genau wie angegeben wiedergegeben. Dasselbe Muster eignet sich für Tafeln, Preisschilder und Verpackungen; halten Sie den Text unter etwa sechs Zeilen. Weitere fünf Muster (darunter eine Speisekarte mit korrekten Preisen) finden Sie in den Seedream 5.0 Lite Prompt-Rezepten.

Bild-zu-Bild: nur eine Stelle ändern, alles andere erhalten

Muster: Beschreiben Sie in einem Satz die Änderung und benennen Sie dann alles, was unverändert bleiben muss.

Gezielte Farbänderung. Originalbild:

Ändern Sie diese matte weiße Keramiktasse in eine Tasse mit dunkelkobaltblauer Glasur und glänzender, reflektierender Oberfläche. Der Dampf, der Eichentisch, das aufgeschlagene Notizbuch, der Füller, die Sukkulente, das Licht und der Kamerawinkel bleiben exakt unverändert, fotorealistisch

seedream-5.0-lite/image-to-image, ein Referenzbild, 3:2, 2K, $0.035.

Text auf einem Schild ersetzen.

Ersetzen Sie den Text auf dem Holzschild an der Tür durch „BAKERY CORNER“. Behalten Sie denselben goldenen Serifenschriftstil und dieselbe Schriftgröße bei. Die Form des Schildes, die Holzmaserung, die Ziegelfassade, die beleuchteten Fenster, der Olivenbaum und das bedeckte Licht bleiben exakt unverändert, fotorealistisch

seedream-5.0-lite/image-to-image, ein Referenzbild, 3:2, 2K, $0.035.

Komposition aus zwei Bildern. Verweisen Sie in der Reihenfolge der Bilder in image_urls auf sie:

Nehmen Sie den Lederrucksack aus dem ersten Bild und platzieren Sie ihn auf dem flachen Granitfindling in der Campszene des zweiten Bildes, natürlich in leichtem Winkel angelehnt, mit neuem Licht passend zum warmen Sonnenlicht der goldenen Stunde und einem weichen Schatten auf dem Felsen. Die Feuerstelle aus Steinen, der Kiefernwald und die Berggipfel bleiben unverändert, fotorealistische Komposition

seedream-5.0-lite/image-to-image, zwei Referenzbilder, 3:2, 2K, $0.035.

Setzen Sie aspect_ratio auf denselben Wert wie beim Eingabebild. Wenn Sie ein anderes Seitenverhältnis anfordern, geht ein Teil der Bearbeitung durch erneutes Zuschneiden verloren.

curl

curl -s -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-lite/text-to-image",
    "input": {
      "prompt": "A cafe chalkboard menu listing exactly three items: '\''FLAT WHITE 4.50'\'', '\''COLD BREW 5.00'\'', '\''CROISSANT 3.80'\''",
      "aspect_ratio": "3:4",
      "resolution": "2K"
    }
  }'

Sie erhalten eine taskId. Fragen Sie GET https://api.hiapi.ai/v1/tasks/{taskId} ab, bis data.status den Wert success hat, und laden Sie dann data.output[0].url herunter. Die Links laufen ab, speichern Sie die Datei daher sofort.

Für eine Bearbeitung ändern Sie das Modell in seedream-5.0-lite/image-to-image und fügen "image_urls": ["https://your-cdn.example.com/input.jpg"] hinzu.

Python: erst generieren, dann bearbeiten

# pip install requests; export HIAPI_KEY=your-key first
import os, time, uuid, requests

API = "https://api.hiapi.ai/v1/tasks"
H = {"Authorization": f"Bearer {os.environ['HIAPI_KEY']}"}

def generate(model, timeout_s=300, **inp):
    body = {"model": model, "input": inp}
    # Reuse the same Idempotency-Key if you retry a submit, so a retry never bills twice
    r = requests.post(API, json=body, headers={**H, "Idempotency-Key": str(uuid.uuid4())}, timeout=30)
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)  # 400s list every invalid field
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"{API}/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(5)
    raise TimeoutError(task_id)

# Generate a packshot
shot = generate("seedream-5.0-lite/text-to-image",
                prompt="Studio photo of a matte-black tea tin labeled 'HILLFOG' on slate, no other text",
                aspect_ratio="1:1", resolution="2K")

# Then make a colorway from it; the generated URL works as a reference
green = generate("seedream-5.0-lite/image-to-image",
                 prompt="Recolor the tin to deep forest green, keep the label, slate and lighting unchanged",
                 image_urls=[shot], aspect_ratio="1:1", resolution="2K")

with open("green.jpg", "wb") as f:
    f.write(requests.get(green).content)

Wenn Sie Ergebnisse später wiederverwenden möchten, laden Sie jedes Ergebnis sofort nach Fertigstellung herunter; die Ausgabelinks laufen ab.

Parameter

Feld	Erforderlich	Werte	Beschreibung
prompt	Ja	4–3.000 Zeichen	Setzen Sie zu rendernden Text in Anführungszeichen
aspect_ratio	Ja	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9	Beim Bearbeiten an die Eingabe anpassen
resolution	Ja	2K, 4K	Großbuchstaben; gleicher Preis
image_urls	Nur Bild-zu-Bild	1–14 URLs	jpeg, png oder webp, maximal 10 MB pro Bild

Es gibt kein seed, negative_prompt oder output_format.

Häufige Fehler

Die folgenden Fehler werden bereits beim Absenden mit HTTP 400 zurückgegeben, sodass keine Aufgabe erstellt und nichts berechnet wird:

• aspect_ratio: missing required field / resolution: missing required field: Beide sind Pflichtfelder, auch wenn die Dokumentation Standardwerte nennt.
• resolution: value must be one of '2K', '4K': Es gibt kein 1K. Verwenden Sie Großbuchstaben.
• image_urls: maxItems: got 15, want 14: Maximal 14 Referenzbilder.
• prompt: minLength: got 2, want 4: Der Prompt muss mindestens 4 Zeichen lang sein.
• additional properties 'output_format' not allowed: Dieses Feld gibt es bei Lite nicht.

Lite, Flash oder Pro?

Modell	Preis pro Bild	Anwendungsfall
Seedream 5.0 Flash	$0.025	Wenn Stapelverarbeitung und Geschwindigkeit am wichtigsten sind
Seedream 5.0 Lite	$0.035 für 2K oder 4K	Text im Bild, feine Bearbeitungen, 4K ohne Aufpreis
Seedream 5.0 Pro	$0.05 (1K) / $0.10 (2K)	Wenn finale Assets maximale Detailtreue benötigen

Einen Vergleichstest der beiden günstigeren Stufen mit demselben Prompt finden Sie unter Seedream 5.0 Flash vs. Lite. Die vollständigen Preise finden Sie unter Seedream 5.0 API-Preise.

Häufige Fragen

Wird jedes Referenzbild zusätzlich berechnet?

Nein. Bild-zu-Bild kostet $0.035 pro Ausgabe, unabhängig davon, ob Sie 1 oder 14 Referenzbilder senden.

Kann chinesischer Text gerendert werden?

Ja. Das Poster oben enthält im selben Bild sowohl einen chinesischen Titel als auch einen englischen Untertitel. Setzen Sie jede Zeichenkette in Anführungszeichen und geben Sie ihre Position an.

Bleibt mein Produkt völlig unverändert?

Es bleibt erhalten, was Sie ausdrücklich nennen. Listen Sie alle Elemente auf, die unverändert bleiben müssen (Form, Beschriftung, Licht, Kamerawinkel); alles, was nicht genannt wird, kann sich ändern.

2K oder 4K wählen?

Der Preis ist derselbe. 2K hat eine lange Kante von etwa 2.300 px, 4K etwa 4.096 px. 2K-Dateien sind kleiner und beim Iterieren leichter anzusehen; wechseln Sie zu 4K, wenn Sie drucken möchten.