Endet in—Wan-Modelle bis zu 45 % unter dem offiziellen Preis
LogoWan API
  • Modelle
  • Entwickler
  • Preise
  • API-Doku
  • Anleitungen
Seedream 5.5 API-Anleitung: Bilder generieren, bearbeiten und zerlegen
12.11.2026

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.json

Eine 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.

Mit Seedream 5.5 generierte Fuchsteekanne aus Keramik auf einer Leinentischdecke

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

Seedream 5.5 Ausgangsplakat, getrennter Hintergrund, Musiker und transparente Textebenen

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:

FeldVerwendung
z_indexPlatziere höhere Werte über niedrigeren.
bounding_box.absolutePlatziere die Ebene anhand von links, oben, rechts und unten in Pixeln des Basisbildes.
bounding_box.normalizedDie entsprechenden Koordinaten auf einer Skala von 0–1000.
name, descriptionIdentifiziere das vom Modell getrennte Element.
text_recognitionLies 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

  1. Seedream 5.5 API-Referenz: Anfragefelder, Standardwerte, URL-Eingaben, asynchrone Antworten und Ebenenmetadaten. API-Spezifikation geprüft am 12. November 2026.
  1. Seedream 5.5 aktuelle Preise: Ausgabepixelbereiche und Referenzbildtarife.
Alle Beiträge

Autor

avatar for Wan API
Wan API

Kategorien

  • Produkt
Beginne mit einem Schlüssel und einer kleinen AnfrageGespeicherte ID abfragen, auch nach dem NeuladenÄndere die Szene und benenne, was bleiben mussZerlege ein Plakat in wiederverwendbare EbenenWähle Abmessungen vor dem KostenvergleichWenn Anfrage oder Ergebnis Aufmerksamkeit benötigenReferenzen

Weitere Beiträge

Seedance 2.0 Fast vs Mini: Was solltest du testen?
Produkt

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.

avatar for Wan API
Wan API
15.10.2026
Seedream 5.0 Pro: Bilder in Ebenen zerlegen – Ergebnisse und Abrechnung
Produkt

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.

avatar for Wan API
Wan API
23.10.2026
Wan 3.0 API: Modelle, Eingaben und dein erstes Video
Produkt

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.

avatar for Wan API
Wan API
13.10.2026

Neuigkeiten von Wan API

Updates zum Dienst und Modellneuigkeiten

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

LogoWan API

Wan 3.0 und Wan 3.0 Prime. Videogenerierung für dein nächstes Projekt.Unabhängige Plattform. Weder mit Alibaba, Wan oder ByteDance verbunden noch von ihnen unterstützt.

X (Twitter)
Featured on Findly.toolsFazierDang.aiFeatured on Twelve Tools
Modelle
  • Wan 3.0
  • Wan 3.0 Prime
  • Wan 3.0 Pro
  • Wan 3.0 Prime Pro
  • Seedance 2.5
  • Seedance 2.0
  • Seedance 2.0 Fast
  • Seedance 2.0 Mini
  • Seedance 2.5 Flash
  • Seedream 5.0 Pro
  • Seedream 5.5
  • Claude Haiku 5.5
  • Claude Sonnet 5.5
  • Claude Opus 5.5
  • Claude Fable 5.2
  • GPT Luna 6
  • GPT Terra 6.1
  • GPT Sol 6.1
  • GPT Astra 6
  • Preise
Entwickler
  • Dokumentation
  • Anleitung zu Wan 3.0
  • FAQ
  • Über Wan API
  • Kontakt zu Wan API
Rechtliches
  • Datenschutz
  • Nutzungsbedingungen
llms.txtllms-full.txtsitemap.xml
© 2026 Wan API. Alle Rechte vorbehalten.