Einführung
Was dieser Endpunkt tut
Seedream 5.0 Pro Ebenenzerlegung nimmt ein fertiges Bild und zerlegt es. Sie erhalten ein sauberes Basisbild, aus dem die herausgelösten Elemente entfernt und der Hintergrund ausgebessert wurden, plus ein transparentes PNG für jedes Element: eine Person, eine Schlagzeile, ein Produkt, ein Requisit. Verschieben, skalieren, ersetzen oder umfärben Sie jedes Teil, oder lassen Sie es weg.
Die Eingaben, auf die es ankommt
image_url ist das einzelne Ausgangsbild (png, jpeg, webp, bmp, tiff oder gif, bis zu 30 MB; HEIC wird nicht unterstützt). prompt ist optional: Lassen Sie ihn leer für die automatische Erkennung, oder nennen Sie die gewünschten Elemente und umranden Sie sie optional mit <bbox>x1 y1 x2 y2</bbox> in Koordinaten von 0–1000. resolution ist auto, 1k, 1.5k oder 2k. output_format (jpeg oder png) gilt nur für das Basisbild.
Inhalte
Ungefilterte Ausgangsbilder können aufgeteilt werden; Ihr Bild wird unverändert an das Modell weitergegeben. In unseren Tests lehnte das Modell Ausgangsbilder der Stufe Sehr stark ab, ohne Berechnung.
Was Sie zurückbekommen
Das erste Bild ist das Basisbild, aus dem die herausgelösten Elemente entfernt und in dem der Hintergrund aufgefüllt wurde (layer.zIndex 0). Jedes weitere Bild ist eine transparente PNG-Ebene in Stapelreihenfolge. Jede Ebene trägt eine boundingBox als [x1, y1, x2, y2] in Pixelkoordinaten des Basisbilds und einen vom Modell vergebenen name, sodass sich die Ebenen exakt an ihre ursprüngliche Stelle setzen lassen. Es gibt insgesamt höchstens 17 Bilder, und die Abrechnung folgt der tatsächlichen Anzahl, das Basisbild eingeschlossen.
| Feld | Wert |
|---|---|
| Eingabe | Bild |
| Ausgabe | Bild |
| Endpunkte | Text to Image, Image to Image |
| Pflichteingabe | Prompt (bis zu 5.000 Zeichen); bei Image to Image zusätzlich 1–10 Referenzbilder |
| Seitenverhältnis | 15 Formate von 1:3 bis 3:1; Image to Image standardmäßig auto (am nächsten an der ersten Referenz) |
| Auflösung | 1k, 1.5k oder 2k (Vorgabe 2k); die Stufe bestimmt Pixelzahl und Preis |
| Reproduzierbarkeit | Kein seed-Feld – identische Anfragen liefern verschiedene Bilder |
| Inhaltsrichtlinie | Unzensiert; kein Reifegrad-Flag, keine Erklärung pro Anfrage |
Wichtige Funktionen und Highlights
Nasse Haut, Seide und Kerzenschatten halten der Nähe stand
Das ist die Stufe, auf der Textur nicht mehr angedeutet, sondern gerendert wird: Wassertropfen auf einem Schlüsselbein, das Gewicht schwerer Seide, der Lichtabfall einer einzelnen Softbox vor schwarzem Hintergrund. Genau deshalb geben Sie hier einen Aufruf aus statt auf einem schnelleren Geschwister, sobald die Richtung feststeht.
Gesicht, Kleidungsstück und Raum in einem Edit zusammenführen
Der Bearbeitungs-Endpunkt nimmt ein bis zehn Referenzbilder. Weisen Sie jeder im Prompt eine Rolle zu – Motiv aus der ersten, Kleidungsstück aus der dritten, Raum aus der fünften –, und er setzt sie zu einem Frame zusammen. Jede zusätzliche Referenz erhöht die Bepreisung, und die Schätzung vor dem Absenden ist das, was abgerechnet wird.
Fünfzehn Formate – und Bearbeitungen, die die Form der Quelle behalten
aspect_ratio reicht von 1:3 bis 3:1 – fünfzehn Formate, darunter 4:5 für Feeds und 21:9 für ein Banner –, und resolution wählt die Stufe 1k, 1.5k oder 2k. Am Bearbeitungs-Endpunkt ist auto die Vorgabe: Die Ausgabe übernimmt das unterstützte Verhältnis, das der ersten Referenz am nächsten liegt, eine Hochformat-Quelle kommt also im Hochformat zurück, solange Sie kein anderes Format verlangen.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
image_url | Ja | Ein zu zerlegendes Bild: png, jpeg, webp, bmp, tiff oder gif, bis zu 30 MB, 262.144 bis 36.000.000 Pixel insgesamt, Seitenverhältnis zwischen 1:16 und 16:1. mindestens 1 Zeichen |
prompt | Nein | Optional, beliebige Länge. Lassen Sie ihn leer, dann wählt das Modell die Hauptelemente selbst; nennen Sie Elemente, dann zerlegt es diese. mindestens 1 Zeichen · höchstens 5000 Zeichen |
resolution | Nein | auto, 1k, 1.5k oder 2k. Das Basisbild behält das Seitenverhältnis der Eingabe, und jede Ebene behält die Proportionen ihres Elements. |
output_format | Nein | jpeg oder png, nur für das Basisbild. Ebenen sind immer transparentes PNG, egal was Sie wählen. |
Preis
| Spezifikation | Preis |
|---|---|
| $0.042 / Bild |
| $0.042 / Bild |
| $0.084 / Bild |
| $0.084 / Bild |
Anwendungsfälle
Unzensierte Editorial-Endfassungen
Kerzenbeleuchtete Innenräume, Beauty-Porträts mit nassem Look, Seide im harten Licht – die Bilder, die eine Kampagne tatsächlich ausliefert. Es gibt kein Reifekennzeichen und keinen separaten Endpunkt: dieselben zwei Endpunkte verarbeiten einen Parfüm-Still und ein ungefiltertes Endergebnis gleich.
Stills für Beauty- und Duftkampagnen
Eine harte Softbox, tiefschwarzer Grund, glänzende Haut und Wasserdetail. Die Materialdarstellung ist nah genug, dass ein Entwurf ein Kundenreview übersteht, statt als Platzhalter wegerklärt zu werden.
Szenenaufbau aus zehn Referenzen
Senden Sie ein Motivfoto, zwei Garderobenreferenzen, eine Requisitenplatte und eine Ortsaufnahme in einem Bearbeitungsaufruf und benennen Sie, was jede beiträgt. Eine Anfrage ersetzt eine Compositing-Sitzung, und das Licht gleicht das Modell an, nicht Sie von Hand.
Finishing-Durchgang, wenn die Richtung steht
Erkunden Sie die Komposition auf einem schnelleren Modell und bringen Sie die funktionierende Formulierung hierher für den Frame, den Sie ausliefern wollen. Der Prompt muss nicht umgebaut werden – neu betrachten sollten Sie nur das Referenzset, das Seitenverhältnis und die Auflösungsstufe.
Prompt-Leitfaden und Praxistipps
Entscheiden, ob Sie erzeugen oder zusammensetzen
Ohne Referenzen ist es Text-to-Image; mit einer bis zehn Referenzen der Bearbeitungs-Endpunkt, bei dem der Ausschnitt der ersten Referenz folgt, sofern Sie
aspect_rationicht setzen. Beide nehmen denselben Prompt mit 5.000 Zeichen, die Wahl hängt also am Ausgangsmaterial, nicht am Umschreiben des Briefings.Das Treatment schreiben, dann den Ausschnitt festlegen
Motiv, Garderobe, Lichtquelle und -richtung, Objektiv, Farblook. Wählen Sie danach das Seitenverhältnis und die Stufe 1k, 1.5k oder 2k. Das Porträt auf dieser Seite entstand aus diesem Prompt (englisch belassen, so wie gesendet): „High-resolution beauty editorial photograph, close portrait of an adult woman with wet hair slicked back, water beading on her collarbone and bare shoulders, a heavy ivory silk robe slipping off one shoulder, arms folded across her chest, dramatic single softbox from camera left, glossy skin texture, deep black background, luxury fragrance campaign look.“
Den Task pollen und das Briefing beim Asset behalten
Task anlegen, auf einen Endzustand pollen, das Bild aus dem Plattformspeicher holen. Ohne seed-Feld lässt sich kein exakter Frame neu zeichnen – speichern Sie den Prompt also neben dem Ergebnis, das Sie behalten.
Einführung
Seedream 5.0 Pro Ebenenzerlegung zerlegt ein fertiges Bild in ein Basisbild und bis zu sechzehn transparente PNG-Ebenen. Jede Ebene kommt mit Positionsrahmen und Namen, sodass Sie die ursprüngliche Komposition wieder aufbauen oder auf einer Arbeitsfläche neu anordnen können.
Entwickelt von ByteDance (Modell-ID dola-seedream-5-0-pro-260628). Nutzen Sie es, wenn die Ebenen exakt an ihre ursprüngliche Stelle zurückkehren müssen.
Einen Modus nach Ausgangsmaterial wählen
| Ausgangsmaterial | Modus |
|---|---|
| Ein fertiges Bild, dessen Teile Sie einzeln brauchen | Seedream 5.0 Pro Ebenenzerlegung |
| Eine schriftliche Art Direction oder ein Design-Brief | Seedream 5.0 Pro Text-zu-Bild |
| Ein freigegebenes Ausgangsbild, das überarbeitet werden soll | Seedream 5.0 Pro Bildbearbeitung |
| Dieselbe Zerlegung, ebenfalls mit Namen und Positionsrahmen, zu einem niedrigeren Preis pro Bild | Seedream 5.0 Flash Ebenenzerlegung |
Pro oder Flash für Ebenen
Beide Stufen liefern für jede Ebene boundingBox und name. Beim selben Filmposter, ohne Prompt ausgeführt, lieferte Pro neun Bilder und Flash acht. Die Unterschiede sind der Preis und eine inhaltliche Grenze. Pro kostet $0.042 pro Ausgabebild bei 1K und 1.5K und $0.084 bei 2K; Flash kostet $0.026 in jeder Stufe. Pro lehnt Ausgangsbilder der Stufe Sehr stark ab, während Flash dieselbe Art von Bild in seine Figuren zerlegt hat. In unseren Läufen war keine der beiden Stufen zuverlässig schneller.
Hauptmerkmale
Positionsrahmen und Namen
Jede Ebene liefert boundingBox als [x1, y1, x2, y2] in Pixeln des Basisbilds und einen name wie „Frau im roten Trenchcoat“. In unserem Posterlauf reproduzierte das Zurücklegen der Ebenen an ihre Rahmen das Originalposter. Ein Ebenen-PNG ist oft größer als der Rahmen, den es einnimmt (ein Rahmen von 671 × 139 kam mit einem PNG von 1233 × 256), skalieren Sie es beim Zurücksetzen also in den Rahmen.
Sauberes Basisbild
Die herausgelösten Elemente werden entfernt und der Hintergrund wird ergänzt. Die Zerlegung der Parfümanzeige hinterließ eine leere schwarze Marmorfläche dort, wo Flakon, Band und Schrift gewesen waren.
Mit Worten oder Koordinaten steuern
Benennen Sie die Elemente oder legen Sie sie mit <bbox>-Koordinaten fest. Ohne Prompt wählt das Modell die Hauptelemente selbst.
Transparente PNG-Ebenen
Ebenen sind immer transparentes PNG, egal welches output_format Sie wählen. Diese Einstellung ändert nur das Basisbild.
Anwendungsfälle
Den Text auf einem Poster ändern
Nehmen Sie die Titelebene heraus, ersetzen oder gestalten Sie sie neu und legen Sie alles an den gelieferten Rahmen wieder übereinander.
Einen Produkthintergrund austauschen
Lösen Sie das Produkt samt Schrift aus einer Anzeige heraus, behalten oder ersetzen Sie das Basisbild und setzen Sie alles für eine neue Kampagne neu zusammen.
Parallax- oder Animationsmaterial bauen
Verwandeln Sie eine Illustration in geordnete Ebenen mit bekannten Positionen, bereit für Tiefenbewegung oder ein Rig.
Eine Person aus einer Szene isolieren
Fragen Sie nur nach der Person und erhalten Sie eine transparente Ebene plus die Szene ohne sie.
Prompt-Leitfaden und Profi-Tipps
Die gewünschten Teile benennen
Bei einem Poster zählen Sie sie in einfachen Worten auf: „Trenne das Diner-Gebäude, die Tagline, den Titel LATE SHIFT, die Frau im roten Trenchcoat und den Kartenabriss ADMIT ONE.“ Dieser Lauf lieferte sechs Bilder: das Basisbild und genau diese fünf Ebenen.
Ein Element mit einem Begrenzungsrahmen umranden
Hängen Sie <bbox>x1 y1 x2 y2</bbox> hinter den Namen des Elements. Die Koordinaten sind ab der linken oberen Ecke auf 0–1000 normiert und hängen daher nicht von der Pixelgröße des Bildes ab.
Separate the title text <bbox>179 58 809 197</bbox> and the parrot <bbox>330 274 641 991</bbox> into independent layers
Eine Auflösung wählen
1k und 1.5k kosten pro Ausgabebild gleich viel; 2k und auto werden zum 2K-Satz abgerechnet, weil auto eine 2K-Ausgabe erzeugen kann. Nutzen Sie 1k oder 1.5k, wenn Sie nur eine Arbeitszerlegung brauchen.
Die Reservierung einplanen
Eine Anfrage reserviert die Kosten für 17 Bilder und erstattet die Differenz, sobald die tatsächliche Zahl der Ebenen feststeht. Typische Ergebnisse sind wenige Bilder.
Inhaltliche Grenzen
Seedream 5.0 Pro · Ebenenzerlegung. SpicyAPI fügt an diesem Endpunkt keinen plattformseitigen Inhaltsfilter hinzu. Die Einschränkungen des Modells gelten weiterhin, Ergebnisse sind nicht garantiert. In unseren Tests wurde jedes ungefilterte Ausgangsbild, das wir probiert haben, aufgeteilt, außer denen der Stufe Sehr stark; diese lehnte das Modell ohne Berechnung ab. Sie sind dafür verantwortlich, unsere Inhaltsrichtlinie einzuhalten.
Ungefilterte Ausgangsbilder können ebenfalls aufgeteilt werden; Ergebnisse sind nicht garantiert. Ausgangsbilder der Stufe Sehr stark werden vom Modell abgelehnt, ohne Berechnung. Reichen Sie keine Materialien mit Minderjährigen, nicht einvernehmlichen intimen Darstellungen oder täuschender Nachahmung realer Personen ein. Dies beschreibt eine Nutzungsgrenze, keine automatische Prüfung jeder Anfrage.
Die Eignung für kommerzielle Zwecke, die Klärung der Rechte und die abschließende redaktionelle Prüfung liegen in Ihrer Verantwortung.
API-Schnellstart
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "bytedance/seedream-5.0-pro/layer-decomposition",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"resolution": "1.5k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.
