
Seedream 5.5 API-Anleitung: Bilder generieren, bearbeiten und zerlegen
Seedream 5.5 einmal aufrufen, Status lesen, mit Referenzen bearbeiten, transparente PNGs und Ebenen erstellen. Ausgabegrößen und aktuelle Bildpreise prüfen.
Seedream 5.5 liefert eine Aufgaben-ID, bevor es ein Bild zurückgibt. Sende die Anfrage einmal, speichere diese ID und frage das fertige Ergebnis ab. Die Generierung erzeugt ein Bild; die Ebenenzerlegung kann ein Basisbild und transparente Ebenen erzeugen. Beide Workflows nutzen model: "seedream-5-5", haben jedoch unterschiedliche Eingaberegeln. 1
Diese Anleitung führt ein Briefing für eine Keramikteekanne durch Generierung und gezielte Bearbeitung und zeigt anschließend die Zerlegung eines bestehenden Plakats in Ebenen. Der Seedream 5.5 Playground bietet dieselben Anfragesteuerungen. Dort kannst du das JSON prüfen, bevor du es in eine Anwendung integrierst.
Die API-Spezifikation wurde am 12. November 2026 geprüft. Unsere Integrationsprüfungen spielten 34 Anfrage- und Antwortfälle erneut ab, darunter inkompatible Transparenzeinstellungen, Ebenengrenzen und abgeschlossene Ausgaben ohne nutzbare Abmessungen. Diese Prüfungen validieren Anfrageverarbeitung und Abrechnungseingaben; sie sind kein Benchmark für Generierungsgeschwindigkeit oder Bildqualität. Die folgenden Bilder sind vorhandene Seedream 5.5 Beispiele vom 10. November.
Beginne mit einem Schlüssel und einer kleinen Anfrage
Erstelle einen Schlüssel unter API-Schlüssel, bewahre ihn auf deinem Server auf und verwende https://api.wanapi.app als Basis-URL. Dein vorhandener Wan API-Schlüssel funktioniert mit allen verfügbaren Modellen und Gruppen. Für dieses Bildmodell musst du keinen separaten Schlüssel kaufen oder auswählen.
Speichere dies als generate.json:
{
"model": "seedream-5-5",
"prompt": "A ceramic teapot shaped like a sleeping fox on a linen tablecloth, soft morning window light, shallow depth of field. No text.",
"size": "1K",
"output_format": "png",
"content_filter": true
}Setze WAN_API_KEY in deiner Serverumgebung und sende dann einmal:
curl --fail-with-body --retry 0 --max-time 90 \
https://api.wanapi.app/seedream55/v1/images/generations \
-H "Authorization: Bearer $WAN_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @generate.json \
-o submitted.jsonEine erfolgreiche Antwort enthält id, model und einen Verarbeitungsstatus. Bewahre die gesamte Datei submitted.json auf. Interpretiere eine fehlende Bild-URL nicht als fehlgeschlagene Generierung: Diese Antwort bestätigt die Aufgabe. Falls die Verbindung abbricht, bevor du eine ID erhältst, prüfe die Aufgabenprotokolle vor einem weiteren POST. Eine ungewisse Antwort ist keine Erlaubnis, dieselbe kostenpflichtige Aufgabe erneut zu erstellen.
Für diese erste Anfrage haben wir 1K ausdrücklich gewählt. Ohne size verwendet die Generierung standardmäßig 2K. PNG ist das Standardformat, Wasserzeichen sind aus und die Inhaltsprüfung ist an. Aufrufer der öffentlichen API können content_filter ausdrücklich ändern; der Playground lässt die Prüfung für gewöhnliche Konten aktiviert. 1
Gespeicherte ID abfragen, auch nach dem Neuladen
Die Abfrage-URL lautet GET /seedream55/v1/tasks/{id}. Eine abgeschlossene Antwort speichert Bilder in output.data; sie verwendet nicht das Antwortformat der synchronen Images API. Jeder Eintrag hat eine URL und seine tatsächliche Pixelgröße.
Dieses Python-Skript liest die gespeicherte Antwort und fragt bis zu zehn Minuten lang ab. Es sendet ausschließlich GET-Anfragen, sodass ein erneuter Aufruf die bestehende Aufgabe fortsetzt:
import json
import os
import time
import urllib.error
import urllib.request
from pathlib import Path
saved = json.loads(Path("submitted.json").read_text())
task_id = saved["id"]
url = f"https://api.wanapi.app/seedream55/v1/tasks/{task_id}"
deadline = time.monotonic() + 600
while time.monotonic() < deadline:
request = urllib.request.Request(
url,
headers={"Authorization": f"Bearer {os.environ['WAN_API_KEY']}"},
)
try:
with urllib.request.urlopen(request, timeout=30) as response:
task = json.load(response)
except urllib.error.HTTPError as error:
if error.code != 429 and error.code < 500:
raise
time.sleep(5)
continue
except (urllib.error.URLError, TimeoutError):
time.sleep(5)
continue
if task["id"] != task_id:
raise RuntimeError("Unexpected task identity")
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "Task failed"))
if task["status"] == "completed":
Path("result.json").write_text(json.dumps(task, indent=2))
for index, image in enumerate(task["output"]["data"], start=1):
print(index, image["size"], image["url"])
break
time.sleep(5)
else:
print("Still waiting. Keep submitted.json and resume this GET later.")Das Zehn-Minuten-Limit gehört zu diesem Beispielclient. Es bricht keine Aufgabe ab und beweist nicht, dass die Generierung fehlgeschlagen ist. Für diese Integration haben wir keinen gemessenen Latenzbereich ermittelt; baue daher einen Wartezustand ein, statt eine feste Sekundenzahl zu versprechen. Speichere die heruntergeladenen Dateien, sobald sie bereit sind; betrachte Ergebnis-URLs nicht als dauerhaften Dateispeicher.

Dieses Beispiel hat 1248 × 832 Pixel. Die 1K-Vorgabe ist eine Auflösungsstufe und kein Versprechen, dass beide Abmessungen 1024 betragen. Lies size aus dem Ergebnis, wenn dein Layout oder deine Kostenberechnung genaue Abmessungen benötigt.
Ändere die Szene und benenne, was bleiben muss
Füge für eine Bearbeitung image mit einer öffentlichen HTTP(S)-URL hinzu. Das kann ein von dir gehostetes Ausgangsfoto oder eine generierte Datei sein, die du heruntergeladen und selbst gehostet hast. Referenzen dürfen keine Dateiuploads, Base64 oder data-URIs sein. Sie müssen während der Verarbeitung erreichbar bleiben. Unterstützte Eingabeformate und Mediengrenzen stehen in der API-Referenz. 1
{
"model": "seedream-5-5",
"image": "https://your-public-host.example/fox-teapot.png",
"prompt": "Keep the fox teapot, its curled tail, ceramic texture and camera angle. Replace the linen tablecloth with dark walnut wood. Keep the soft light coming from the left. No text.",
"size": "1K"
}Die obige URL ist ein Platzhalter; ersetze sie durch dein erreichbares Bild. Sende sie als separate, bewusst erstellte Bearbeitungsaufgabe und speichere die Antwort unter einem neuen Dateinamen. Das Modell erinnert sich nicht an die vorherige Aufgabe: Du musst das zu bearbeitende Bild senden.
Für mehrere Referenzen akzeptiert image ein Array mit bis zu zehn URLs. Gib jedem Bild im Prompt eine Rolle, etwa das Produkt aus Bild eins und die Umgebung aus Bild zwei. Beginne mit der kleinsten sinnvollen Auswahl. Wenn das Ergebnis ein wichtiges Detail verändert, lässt sich mit weniger Referenzen leichter feststellen, welche Anweisung oder Quelle die Änderung ausgelöst hat.
Erhaltung ist eine Anweisung und keine Pixelsperre. Vergleiche nach jeder Bearbeitung Produktsilhouette, Beschriftungen und Kamerawinkel mit dem Original. Setze bei Plakaten die genaue Überschrift in Anführungszeichen und prüfe Zeichensetzung, Namen und Daten in der vorgesehenen Darstellungsgröße. Kleine oder stilisierte Schrift kann weiterhin manuelle Korrekturen benötigen; diese Anleitung verspricht für keine Sprache eine gemessene Genauigkeitsrate.
Füge für einen Freisteller "background": "transparent" hinzu und behalte "output_format": "png" bei. JPEG kann diesen Alphakanal nicht enthalten. Die Transparenzoption ist für Generierung und Bearbeitung verfügbar; für den Ebenenmodus gelten die folgenden eigenen Regeln.
Zerlege ein Plakat in wiederverwendbare Ebenen
Die Ebenenzerlegung nimmt genau ein Bild entgegen. Ein Prompt ist optional: Lasse ihn weg, damit das Modell die Elemente auswählt, oder benenne die zu trennenden Teile. Beginne beim Beurteilen eines Designs mit einer kleinen Ausgabeobergrenze:
{
"model": "seedream-5-5",
"image": "https://your-public-host.example/poster.png",
"size": "1K",
"layer_decomposition": true,
"layer_decomposition_options": {
"max_images": 4,
"text_recognition": true
},
"output_format": "png"
}max_images zählt auch das Basisbild. Vier erlaubt daher das Basisbild plus bis zu drei Ebenen. Die zulässige Obergrenze beträgt 2–100, der Standardwert 30; das Modell kann weniger Bilder liefern. Sende in diesem Modus kein background, auch nicht als auto. Zerlegte Ebenen sind bereits transparente PNGs; output_format steuert das Basisbild. 1

Diese vorhandene Vorschau kombiniert das Ausgangsplakat und zurückgegebene transparente Elemente. Sie veranschaulicht die Zerlegung, garantiert aber nicht, dass jedes Plakat dieselbe Ebenenanzahl oder saubere Grenzen liefert.
Prüfe optionale Metadaten neben jedem Ergebnis:
| Feld | Verwendung |
|---|---|
z_index | Platziere höhere Werte über niedrigeren. |
bounding_box.absolute | Platziere die Ebene anhand von links, oben, rechts und unten in Pixeln des Basisbildes. |
bounding_box.normalized | Die entsprechenden Koordinaten auf einer Skala von 0–1000. |
name, description | Identifiziere das vom Modell getrennte Element. |
text_recognition | Lies erkannten Text, Zeilen und verfügbare Stilinformationen. |
Bewahre das vollständige Ergebnis-JSON auf, nicht nur die URLs. Die Bildgröße einer Ebene kann von ihrer Platzierung auf der Basisarbeitsfläche abweichen. Verwende beim Wiederaufbau der Komposition den Begrenzungsrahmen und prüfe das Ergebnis visuell. Schriftvorschläge sind Schätzungen; OCR-Metadaten garantieren weder die Originalschrift noch eine fertige PSD-Datei. Künstlerische Schrift, überlappende Elemente und durch deinen Prompt ausgeschlossener Text können zu unvollständigen Ergebnissen führen.
Wähle Abmessungen vor dem Kostenvergleich
Die Generierung unterstützt 1K, 1.5K und 2K sowie genaue WIDTHxHEIGHT-Abmessungen innerhalb von insgesamt 921.600–4.624.220 Pixeln und einem Seitenverhältnis von 1:16 bis 16:1. Der Ebenenmodus akzeptiert diese Vorgaben oder auto, jedoch keine genauen Abmessungen. Diese API bietet keine 3K- oder 4K-Vorgabe, kein Batch-n, keinen Seed und keinen schnellen Promptoptimierungsmodus. Parameter einer anderen Seedream-Version sollten nicht ungeprüft übernommen werden. 1
Die aktuellen Tarife stammen hier aus derselben Preisquelle wie im Playground:
Preise sind derzeit nicht verfügbar. Lade diese Seite neu, um es erneut zu versuchen.
Tarife werden automatisch aktualisiert. Ein API-Schlüssel funktioniert mit allen Modellen und Gruppen.
Sei L der Ausgabetarif bis 2,61 Millionen Pixel, H der Tarif oberhalb dieser Grenze und R der Referenzbildtarif. Eine 1K-Generierung ohne Referenz kostet L; eine Bearbeitung mit einer Referenz kostet L + R. Sowohl 1K als auch 1.5K nutzen den niedrigeren Ausgabetarif. Jede Referenz wird berechnet, auch die erste. 2
Eine 1K-Ebenenanfrage mit vier Bildern wird mit 4L + R geschätzt. Liefert sie nur das Basisbild und zwei Ebenen, jeweils innerhalb des niedrigeren Bereichs, betragen die endgültigen Kosten 3L + R. Zähle bei gemischten Ausgabegrößen jedes Bild einzeln: Zwei Bilder im niedrigeren Bereich und ein größeres Bild kosten 2L + H + R. Das Basisbild ist ein Ausgabebild und darf bei dieser Zählung nicht fehlen.
Die anfängliche Reservierung deckt die gewählte Obergrenze ab. Nicht benötigtes Guthaben wird nach Abrechnung der tatsächlichen Ausgaben freigegeben; eine fehlgeschlagene Aufgabe wird erstattet. In unseren Abrechnungstests veränderte das erneute Abspielen derselben abgeschlossenen Antwort das Guthaben kein zweites Mal. Wir prüften außerdem, dass ein Abschluss ohne alle erforderlichen Bildnutzungsdaten unabgerechnet blieb, statt geschätzte Mengen als beobachtete Ausgabe zu behandeln.
Wenn Anfrage oder Ergebnis Aufmerksamkeit benötigen
Ein Validierungsfehler weist meist auf einen Moduskonflikt hin: mehrere Referenzen im Ebenenmodus, transparentes JPEG, eine nicht unterstützte Größe oder Ebenenoptionen in einer Generierungsanfrage. Korrigiere die Anfrage, bevor du eine neue Aufgabe erstellst. Ein vorübergehender Abfragefehler ist anders zu behandeln: Behalte die bestehende ID und wiederhole den GET. Das sind separate Entscheidungen; ein allgemeiner „alles wiederholen“-Handler kann kostenpflichtige Generierungen duplizieren.
Vergleiche bei einer schlechten Bearbeitung jeweils eine Änderung mit dem Ausgangsbild. Eine größere Ausgabe belegt nicht, dass das Modell eine Beschriftung erhalten oder eine Überschrift korrekt dargestellt hat. Prüfe bei Ebenen die Kanten und fehlende Metadaten, bevor du das Ergebnis in ein produktives Design importierst. Die Inhaltsprüfung bleibt standardmäßig aktiviert; eine Inhaltsablehnung sollte kein automatisches erneutes Senden mit deaktivierter Prüfung auslösen.
Seedream 5.5 passt zu Workflows, die gemäß dieser API-Spezifikation Generierung, Referenzbearbeitung oder trennbare Designelemente benötigen. Seedream 5.0 Pro ist ein separates Modell mit anderen Standardwerten und Grenzen. Wir haben keinen kontrollierten Vergleich durchgeführt, der die Behauptung stützt, eines sei immer besser. Diese Anleitung behauptet auch weder eine separate Verfügbarkeit von „5.5 Pro“ noch eine kostenlose Generierung. Prüfe auf der Modellseite den aktuellen Playground und Preis oder nutze das OpenAPI-Dokument, um die Anfragevalidierung in deine Anwendung einzubauen.
Referenzen
- Seedream 5.5 API-Referenz: Anfragefelder, Standardwerte, URL-Eingaben, asynchrone Antworten und Ebenenmetadaten. API-Spezifikation geprüft am 12. November 2026.
- Seedream 5.5 aktuelle Preise: Ausgabepixelbereiche und Referenzbildtarife.
Kategorien
Weitere Beiträge

Seedance 2.0 Fast vs Mini: Was solltest du testen?
Vergleiche Grenzen, Referenzvideo-Abrechnung und Beispiele von Seedance 2.0 Fast und Mini. Prüfe Qualität, Dauer und Kosten mit demselben Briefing.


Seedream 5.0 Pro: Bilder in Ebenen zerlegen – Ergebnisse und Abrechnung
Bilder mit Seedream 5.0 Pro per API in Ebenen zerlegen: Eingabevorgaben, Größen, zurückgegebene Ebenendaten und vorab prüfbare Kosten pro Ebene.


Wan 3.0 API: Modelle, Eingaben und dein erstes Video
Vergleiche die API-Eingaben und Videoausgabe von Wan 3.0, Wan 3.0 Prime, Wan 3.0 Pro und Wan 3.0 Prime Pro und plane deinen ersten Integrationstest.

Neuigkeiten von Wan API
Updates zum Dienst und Modellneuigkeiten
Melde dich für Modellneuigkeiten, Updates zum Dienst und Informationen zur API-Integration an.