Die Seedream-4.0-Bearbeitung nimmt 1 bis 10 Referenzbilder entgegen und liefert ein Bild in einer von sechzehn Größenvorgaben. Es kostet 0,03 $ pro Bild, bei jeder Größe und jeder Zahl an Referenzen. Es gibt keine Maske, keinen Stärkeregler und keinen Seed, daher steuert allein der Prompt das Ergebnis: Nutzen Sie das Modell für Änderungen an Kleidung, Hintergrund und Licht oder um aus einer Skizze ein Rendering zu machen, nicht für Bearbeitungen, bei denen jedes andere Pixel unverändert bleiben muss.
SpicyAPI setzt bei diesem Editor keinen zusätzlichen Inhaltsfilter auf Plattformebene ein. In unseren Tests im September 2026 fielen Bearbeitungen mit höherer Intensität im Erwachsenenbereich manchmal milder aus als gewünscht, obwohl die Aufgabe als erfolgreich angezeigt wurde. Prüfen Sie das Bild also, bevor Sie es verwenden.
Jeder Referenz eine Aufgabe geben
Senden Sie die Bilder in image_urls und beziehen Sie sich im Prompt der Reihe nach darauf: Bild eins, Bild zwei und so weiter. Eine Referenz, die Sie nicht erwähnen, wird nicht ignoriert, sondern ins Ergebnis eingemischt. Geben Sie jeder Quelle genau eine Aufgabe und sagen Sie, was erhalten bleiben muss.
Für eine Kleidungsänderung laden Sie ein freigegebenes Bild einer fiktiven erwachsenen Person in einer schlichten Jacke hoch, wählen 1728*2304 und verwenden:
Behalte Gesicht, Frisur, Haltung, Hände, Kameraperspektive und Hintergrund der fiktiven erwachsenen Person aus Bild eins bei. Ersetze nur die Jacke durch einen undurchsichtigen burgunderroten Samtblazer über dem vorhandenen cremefarbenen Hemd. Behalte die ursprüngliche Jackenlänge und die Schulterform bei. Zeige einen weichen Samtschimmer im vorhandenen Licht, mit klaren Revers und ohne neuen Schmuck oder Text.
„Mach das Outfit luxuriöser“ lässt den Schnitt offen und kann ein ganz anderes Kostüm ergeben. Soll es genau ein bestimmter Blazer sein, fügen Sie ihn als Bild zwei hinzu und ändern den Materialsatz in: „Bild zwei bestimmt Schnitt, Revers und Stoff des burgunderroten Blazers. Verwende nur dieses Kleidungsstück; Person, Pose und Szene bleiben aus Bild eins.“ Schneiden Sie das Kleidungsfoto auf das Kleidungsstück zu, denn ein vollständiges Modefoto bringt auch Gesicht, Körper und Licht mit.
SpicyAPI akzeptiert bis zu zehn Referenzen. Jede Datei kann ein JPG, PNG, WEBP oder GIF mit bis zu 10 MB sein, für Bilder, an denen Sie die Rechte besitzen.
Die exakte Größe wählen
Seedream 4.0 erwartet size als String im Format width*height, nicht die Felder resolution und aspect_ratio der 5.0-Modelle. Der Standard ist 2048*2048. Das Ergebnis wird in der gewählten Vorgabe neu aufgebaut und nicht aus der Quelle zugeschnitten; sendet man also eine Hochformatquelle mit dem quadratischen Standard, wird sie neu komponiert und der Bildausschnitt kann sich ändern. Passen Sie die Größe an die Form der Quelle an.
| Gewünschte Form | Standardgröße | Größere Variante |
|---|---|---|
| Quadrat | 2048*2048 | 3072*3072 |
| 4:3 Querformat | 2304*1728 | 3456*2592 |
| 3:4 Hochformat | 1728*2304 | 2592*3456 |
| 3:2 Querformat | 2496*1664 | 3744*2496 |
| 2:3 Hochformat | 1664*2496 | 2496*3744 |
| 16:9 Querformat | 2848*1600 | 4096*2304 |
| 9:16 Hochformat | 1600*2848 | 2304*4096 |
| Ultrabreit (21:9) | 3136*1344 | keine |
1024*1024 ist die übrige Vorgabe. Andere Abmessungen werden abgelehnt. 4096*2304 ist das größte Format unter den Seedream-Editoren bei SpicyAPI; 5.0 Lite endet bei 3136*1344.
Es gibt keine 4:5-Vorgabe. Für eine 4:5-Social-Karte nutzen Sie entweder 1728*2304 und lassen Platz für einen leichten Zuschnitt, oder Sie wechseln zu Seedream 5.0 Flash (0,029 $ pro Bild) oder 5.0 Pro, die aspect_ratio: 4:5 akzeptieren. Pro beginnt bei 0,036 $ pro Bild und kostet bei 2K und mit zusätzlichen Referenzen mehr.
Zuerst im Playground ausprobieren
Führen Sie die Bearbeitung im Playground aus, bevor Sie Code schreiben. Ein Ergebnis, das hier nicht stimmt, stimmt auch über die API nicht, und die Lösung ist ein besserer Prompt oder eine bessere Referenz.
- Öffnen Sie die Seite zur Seedream-4.0-Bearbeitung und bleiben Sie im Tab Playground in der Ansicht Form. Zum Ausführen melden Sie sich mit einem aufgeladenen Konto an.
- Fügen Sie Ihre Quellen unter Images hinzu: Datei ablegen oder Link mit Add URL einfügen. Bis zu 10; die Reihenfolge des Hinzufügens ist „Bild eins“, „Bild zwei“.
- Beschreiben Sie die Änderung im Feld Prompt und nennen Sie, was jedes Bild beisteuert und was erhalten bleiben muss.
- Wählen Sie Output size passend zur Form der Quelle.
- Prüfen Sie die Preisschätzung und starten Sie dann. Die Ansicht JSON zeigt den Request-Body, den Sie in Code kopieren können.
Dann per Code aufrufen
Installieren Sie das Python-SDK (pip install spicyapi), setzen Sie SPICY_API_KEY in Ihrer Serverumgebung und führen Sie aus:
import uuid
from spicyapi import SpicyClient, output_assets
client = SpicyClient() # reads SPICY_API_KEY from the environment
task = client.create_task(
model="bytedance/seedream-4.0/edit",
input_data={
"image_urls": [
"https://example.com/person.png",
"https://example.com/blazer.png",
],
"prompt": "Keep the person, pose and scene from image one. Image two defines the burgundy blazer cut, lapels and fabric; use its garment only.",
"size": "1728*2304",
},
idempotency_key=str(uuid.uuid4()),
)
final = client.wait_for_terminal(task["taskId"])
if final["state"] != "succeeded":
raise RuntimeError(f"Task {task['taskId']} ended as {final['state']}")
print(output_assets(final)[0]["url"]) # copy it to your own storage nowErsetzen Sie die beiden Beispiel-URLs durch Ihre eigenen; sie müssen ohne Login erreichbar sein, oder Sie laden eine lokale Datei hoch und übergeben die zurückgegebene spicy://-URI. Der Ergebnislink läuft nach etwa 20 Minuten ab (Details zur Aufbewahrung). Angebote, Uploads, Warten, Wiederholungen und Fehler stehen in der Python-SDK-Referenz und im Leitfaden zu asynchronen Aufgaben.
Oder einen Agenten ausführen lassen
Wenn ein Assistent die Bearbeitungen für Sie ausführen soll, geben Sie ihm die CLI, den MCP-Server oder den Skill. CLI und MCP-Server zeigen den Preis und fragen Sie vor einem kostenpflichtigen Aufruf.
- CLI. Legen Sie dasselbe
input-Objekt ininput.jsonab und führen Sie dann Folgendes aus (npx @spicyapi/clifunktioniert ohne Installation; siehe CLI-Dokumentation):
``bash spicyapi tasks create --model bytedance/seedream-4.0/edit --input-file input.json --wait ``
- MCP-Server. Fügen Sie den MCP-Server Ihrem Assistenten hinzu und fragen Sie dann: „Bearbeite ./portrait.png mit Seedream 4.0: ersetze nur die Jacke durch einen burgunderroten Samtblazer, Größe 1728*2304.“ Er ruft
spicyapi_upload_fileauf, dannspicyapi_task_create, das für Ihre Preisbestätigung anhält, und danachspicyapi_task_wait. - Skill.
npx skills add spicyapi-ai/spicy-skillinstalliert den Agent Skill, mit dem ein Coding-Assistent das aktuelle Modellschema liest, statt Felder zu raten.
Aus einer Skizze ein Materialkonzept machen
Legen Sie die Skizze an die erste Stelle und ein Materialmuster an die zweite, und sagen Sie, wem was gehört. Ein fiktives Uhrenbeispiel:
Verwandle die Uhrenskizze aus Bild eins in ein realistisches Produktkonzept. Behalte das durchgehende gewölbte Gehäuse, das mittig sitzende runde cremefarbene Zifferblatt und die zwei kurzen Füße bei. Nutze Bild zwei nur für Walnussfarbe und Maserung. Gib den Füßen eine matte Messingoberfläche und dem Zifferblatt zwei schlichte schwarze Zeiger. Frontale Ansicht auf einer hellen Steinfläche, weiches Seitenlicht, keine Markenzeichen und keine zusätzlichen Objekte.
Dieselbe Aufteilung funktioniert bei einem Kostüm: Die Zeichnung bestimmt die Silhouette, ein Stoffbild die Oberfläche, ein freigegebenes Porträt die fiktive Trägerperson. Verwenden Sie eine saubere Skizze, aus der abgebrochene Linien entfernt sind. Eine reine Frontalskizze kann keine Seitenansicht festlegen. Fordern Sie daher zuerst ein frontales Ergebnis an, wenn die Kontur wichtig ist.
Typische Fehler beheben
Das neue Outfit hat das Gesicht verändert. Gehen Sie zurück zum Original-Porträt, entfernen Sie zusätzliche Personen aus der Kleidungsreferenz und behalten Sie die ursprüngliche Ansicht bei. Muss das Gesicht pixelgenau bleiben, montieren Sie das freigegebene Gesicht auf herkömmliche Weise ein, statt eine weitere komplette Neuzeichnung anzufordern.
Das Material hat sich auf andere Objekte ausgebreitet. Benennen Sie die Oberfläche: Samt gehört nur zum Blazer, das Hemd bleibt cremefarbene Baumwolle; Walnuss gehört zum Uhrengehäuse, nicht zum Zifferblatt oder zu den Messingfüßen. Ein schmales Muster ist klarer als ein ganzer Raum als „Stil“-Bild.
Die Silhouette der Skizze hat sich verändert. Vereinfachen Sie die Skizze und verlangen Sie eine Frontalansicht. Ein dramatischer Winkel kann die Kontur verdecken, die Sie behalten wollten.
Das Motiv ist angeschnitten. Wählen Sie eine Vorgabe, die zur Form passt, und bitten Sie um Platz um Kopf, Füße oder Requisite.
Ein kleines Logo oder ein Satz ist falsch. Behalten Sie die Szene und ersetzen Sie dieses Element in einem herkömmlichen Editor. Ohne Maske ist eine Textkorrektur eine neue Zeichnung und kein lokaler Flicken.
Wiederholte Bearbeitungen driften. Jeder Durchgang zeichnet das Bild neu. Verwenden Sie für kumulative Änderungen das zuletzt akzeptierte Ergebnis und prüfen Sie, was sich verschoben hat; kehren Sie zum Original zurück, nehmen Sie alle akzeptierten Änderungen in den Prompt auf. Starten Sie unabhängige Varianten von einem gemeinsamen Original.
Kosten und wann ein anderes Modell besser passt
Drei Bearbeitungen kosten 0,09 $ und zehn kosten 0,30 $. Größere Vorgaben und zusätzliche Referenzen kosten nichts extra. Für ein neues Bild ohne Quelle nutzen Sie Seedream 4.0 Text-zu-Bild, das dieselben Größen und denselben Preis hat.
Wählen Sie 4.0 für große Formate bis 4096*2304 zum Festpreis. Wählen Sie ein 5.0-Modell, wenn Sie aspect_ratio wie 4:5, PNG-Ausgabe (alle 5.0-Modelle) oder transparente Hintergründe (Flash und Pro) brauchen. Wählen Sie ein anderes Verfahren, wenn Sie eine Maske, erhaltene Pixel oder exakte technische Geometrie benötigen. Für Werbemotive aus Produktfotos siehe Produktfoto zu Werbemotiv.






