Seedream 5.0 Pro Text-zu-Bild API-Integration: curl, Python und Tipps für das Schreiben von Text

Seedream 5.0 Pro Text-zu-Bild (seedream-5.0-pro/text-to-image) ist die teuerste Stufe der Seedream 5.0-Familie; ihre Stärke ist Text im Bild: Schilder, Verpackungen und Postertitel werden anhand des Prompts buchstabengetreu geschrieben. Dieser Artikel bietet direkt ausführbare curl- und Python-Beispiele, alle Parameter, häufige Fehler und einige Methoden, um Text korrekt schreiben zu lassen.

Zuerst der Preis

Auflösung	Pro Bild	100 Bilder
1K	$0.05	$5
2K (Standard)	$0.10	$10

HiAPI-Aktuelpreis, überprüft am 18. Oktober 2026.

Das Seitenverhältnis beeinflusst den Preis nicht; bei Fehlschlägen wird nichts berechnet. Pro hat kein 4K; für 4K kann Seedream 5.0 Lite verwendet werden (2K/4K zum gleichen Preis von $0.035). Den Vergleich der drei Stufen finden Sie unter Seedream 5.0 API-Preise.

Ein echtes Generierungsergebnis

16:9, 1K, der Text auf dem Neonschild wird buchstabengetreu korrekt geschrieben:

A neon-lit night market street in a rainy cyberpunk city, a glowing storefront sign reads "SEEDREAM 5 PRO" in crisp lettering, cinematic composition, dramatic directional lighting, rich cohesive color grade, ultra-detailed, premium commercial finish, subtle film grain, shallow depth of field, high dynamic range

Mit diesem Prompt generieren →

seedream-5.0-pro/text-to-image, 16:9, 1K, $0.05.

Das erste Bild zum Laufen bringen

Vorbereitung: Erstellen Sie im Dashboard einen API Key und setzen Sie ihn als Umgebungsvariable:

export HIAPI_KEY="Ihr Key"

curl: Aufgabe einreichen

curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedream-5.0-pro/text-to-image",
    "input": {
      "prompt": "A cozy coffee shop storefront at dusk, warm window light, a hand-painted wooden sign that reads \"THE DAILY GRIND\" in serif letters",
      "aspect_ratio": "16:9",
      "resolution": "2K"
    }
  }'

Gibt taskId zurück:

{"code": 200, "message": "success", "data": {"taskId": "tk-hiapi-..."}}

curl: Ergebnis abfragen

curl "https://api.hiapi.ai/v1/tasks/tk-hiapi-..." \
  -H "Authorization: Bearer $HIAPI_KEY"

Wenn data.status den Wert success hat, befindet sich die Bildadresse in data.output[0].url. Dies ist ein temporärer Link mit Ablaufzeit; laden Sie ihn sofort herunter:

curl -o result.png "<die url aus output>"

2K dauert in der Regel etwa eine Minute.

Python (nur Standardbibliothek)

import json, os, time, urllib.request

API = "https://api.hiapi.ai/v1/tasks"
KEY = os.environ["HIAPI_KEY"]

def api(url, payload=None):
    req = urllib.request.Request(
        url,
        data=json.dumps(payload).encode() if payload else None,
        headers={"Authorization": f"Bearer {KEY}", "Content-Type": "application/json"},
        method="POST" if payload else "GET",
    )
    with urllib.request.urlopen(req) as resp:
        return json.loads(resp.read())

task_id = api(API, {
    "model": "seedream-5.0-pro/text-to-image",
    "input": {
        "prompt": 'A minimalist product poster on matte black, bold white headline that reads "SHIP FASTER", small caption "batch v2.1" bottom right',
        "aspect_ratio": "3:4",
        "resolution": "2K",
    },
})["data"]["taskId"]

while True:
    task = api(f"{API}/{task_id}")["data"]
    if task["status"] == "success":
        break
    if task["status"] == "fail":
        raise RuntimeError(task)
    time.sleep(5)

urllib.request.urlretrieve(task["output"][0]["url"], "result.png")

Alle Parameter

Feld	Erforderlich	Werte
prompt	Ja	3–4000 Zeichen, empfohlen sind etwa höchstens 600 englische Wörter
aspect_ratio	Ja	1:1, 4:3, 3:4, 16:9, 9:16, 2:3, 3:2, 21:9
resolution	Ja	1K ($0.05) oder 2K ($0.10)
output_format	Nein	png (Standard) oder jpeg

Die Felder sind streng: seed, n, size, image_urls werden nicht akzeptiert; zusätzliche Angaben führen zu HTTP 400. Eine Anfrage erzeugt ein Bild; für mehrere Bilder reichen Sie mehrere Aufgaben parallel ein.

Die Auflösungen unterscheiden sich innerhalb der Familie: Pro bietet 1K/2K, Lite bietet 2K/4K. Denken Sie beim Wechsel zwischen den Stufen daran, resolution anzupassen.

Text korrekt schreiben lassen

• Den gewünschten Text in Anführungszeichen setzen: a sign that reads "OPEN 24 HOURS" ist deutlich zuverlässiger als eine Umschreibung.
• Position und Stil klar angeben: Schriftwirkung (Serif, Handschrift, Neon), Position (unten rechts, zentriert), Träger (Holzschild, Glastür).
• Nicht zu viel Text: Ein paar kurze Textstellen pro Bild sind sehr stabil, große Textblöcke weniger.
• Wenn Text im Fokus steht, 2K verwenden: Kleine Schrift ist bei höherer Auflösung klarer.

Häufige Fehler

Symptom	Antwort	Behebung
Pflichtfeld fehlt	400, missing required field "aspect_ratio"	Alle drei Pflichtfelder müssen übergeben werden
Ungültiger Enum-Wert	400, resolution: value must be one of '1K', '2K'	Gemäß der obigen Tabelle ausfüllen
Zusätzliche Angaben wie seed, n usw.	400, additional properties ... not allowed	Überflüssige Felder entfernen
Key ungültig	401, permission_denied	Key im Dashboard prüfen

Wenn eine Aufgabe nach der Erstellung fehlschlägt, steht in der Ergebnisabfrage status: "fail"; es wird nichts berechnet.

Vor dem Go-live beachten

• Callbacks statt Polling verwenden: Fügen Sie auf der obersten Ebene des Request-Bodys (auf derselben Ebene wie model und input) "callback": {"url": "https://Ihre-Domain/hooks/hiapi", "when": "final"} hinzu. Nach Eingang der Benachrichtigung bestätigen Sie das Ergebnis mit einem weiteren GET auf die Aufgabe.
• Doppelte Berechnung vermeiden: Eine Aufgabe wird ab Annahme berechnet. Bevor Sie es erneut versuchen, prüfen Sie, ob Sie die taskId dieser Aufgabe notiert haben; falls ja, fragen Sie weiter ab und reichen Sie nicht erneut ein; alternativ können Sie beim Einreichen den Request-Header Idempotency-Key mitgeben.
• Rechtzeitig speichern: Ausgabelinks laufen ab; verlinken Sie sie nicht direkt extern.

Häufige Fragen

Kann man mit festem Seed reproduzieren?

Nein, diese Schnittstelle akzeptiert kein seed. Wenn Sie auf Basis eines vorhandenen Bildes eine ähnliche Version erzeugen möchten, verwenden Sie seedream-5.0-pro/image-to-image, wobei bis zu 10 Referenzbilder übergeben werden können.

Was ist der Unterschied zu Lite?

Lite kostet $0.035 pro Bild mit den Auflösungen 2K/4K; Pro bietet 1K/2K, wobei 2K $0.10 pro Bild kostet. Die Aufrufweise ist identisch. Den Vergleich von Flash und Lite mit demselben Prompt finden Sie unter Seedream 5.0 Flash vs Lite.

Muss man unbedingt Callbacks verwenden?

Nein. Bei Skripten und Batch-Aufgaben reicht direktes Polling, alle 5 Sekunden eine Abfrage.

Sie können auch direkt den obigen Neon-Schild-Prompt kopieren und für $0.05 ein Bild generieren.