/image/edit oder /image/multi-edit, und das bearbeitete Ergebnis kommt in derselben Antwort als PNG-Datei zurück. Für Freisteller liefert /image/background-remove ein transparentes PNG.
Endpoints
Wann welcher Endpoint?
/image/editverwenden, wenn du ein Quellbild hast und einen Teil davon per Prompt verändern, entfernen oder umstilen willst./image/multi-editverwenden, wenn du zusätzliche Kontrolle durch Masken, Overlays oder Referenz-Layer brauchst./image/background-removeverwenden, wenn du nur ein sauberes Vordergrundmotiv mit Transparenz brauchst.
Für Inpainting
/image/edit oder /image/multi-edit verwenden. Der alte inpaint-Parameter auf /image/generate ist deprecated.Schritt 1: Ein einzelnes Bild bearbeiten
Single-Image-Edit ist der einfachste Inpainting-Flow. Sende ein Bild plus einen kurzen Prompt wie „remove the sign”, „change the sky to sunrise” oder „replace the background with a studio backdrop”. Request:image/png-Binärdaten. Speichere sie direkt in eine Datei.
Schritt 2: Multi-Edit für Masken oder mehrschichtiges Inpainting nutzen
/image/multi-edit akzeptiert bis zu drei Bilder. Das erste Bild ist das Basis-Bild. Die weiteren Bilder werden als Edit-Layer oder Masken behandelt – das gibt dir mehr Kontrolle als reines Prompt-Editing.
Das ist die bessere Wahl, wenn du:
- eine bestimmte Region per Maske gezielt ansprechen willst
- eine bestehende Komposition mit einem Overlay kombinieren willst
- den Edit enger einschränken willst, als es ein Single-Image-Prompt erlaubt
/image/edit sind die Response-Body rohe image/png-Daten.
/image/multi-edit verwendet im Request-Schema derzeit das Feld modelId statt model.Inpainting-Tipps
Prompt-basiertes Inpainting funktioniert am besten, wenn die Anweisung kurz und lokal ist:remove the treechange the sky to sunsetreplace the logo with a blank signrestore the torn corner of the photo
/image/edit zu /image/multi-edit und übergib einen Masken- oder Overlay-Layer.
Schritt 3: Hintergrund entfernen
Verwende/image/background-remove, wenn du das Vordergrundmotiv auf transparentem Hintergrund isoliert haben willst. Dieser Endpoint liefert ein PNG mit Alpha-Transparenz.
Per Bild-URL:
- E-Commerce-Produktfotos
- Profilbilder und Porträts
- Assets, die du auf einen neuen Hintergrund legen willst
Request-Parameter
/image/edit
/image/multi-edit
/image/background-remove
Unterstützte Eingabeformate
Für Edit-Endpoints müssen die Bilddimensionen mindestens
65536 Pixel und höchstens 33177600 Pixel betragen. Uploaded files müssen unter 25MB sein.
Modelle und Preise
Das Default-Edit-Modell istqwen-edit, $0,04 pro Edit. Andere edit-fähige Modelle können andere Preise und Einschränkungen haben. Prompt-Enhancement erhöht den Edit-Preis um $0,04 pro angewendetem Rewrite.
Siehe:
- Image-Preise
- Models-API mit
type=inpaint
Fehler
Einige Edit-Modelle haben strengere Content-Policies als Image-Generation-Modelle. Zum Beispiel blockiert
qwen-edit Anfragen, die explizite sexuelle Inhalte, sexualisierte Minderjährige oder reale Gewalt betreffen.Verwandte Workflows
- Nutze Bildgenerierung, wenn du nicht von einem Bild, sondern von Text startest.
- Nutze Prompt-Enhancement, um zu lernen, wie Vision-fähiges Umschreiben von Edits funktioniert.
- Nutze Image-Modelle, um Generations-, Edit- und Enhancement-Modellfamilien zu vergleichen.
- Nutze Image-Edit-API, Multi-Edit-API und Background-Remove-API für vollständige Schema-Details.