/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 mehrere Bilder, und die Obergrenze ist modellspezifisch: Die meisten Edit-Modelle erlauben 3, während die höherstufigen — darunter gpt-image-2-edit, nano-banana-pro-edit, seedream-v5-pro-edit, flux-2-max-edit und wan-2-7-pro-edit — bis zu 6 erlauben. Lies model_spec.constraints.maxInputImages aus GET /models?type=inpaint, um die Obergrenze für ein bestimmtes Modell zu erhalten; fehlt das Feld, liegt die Obergrenze bei 3.
Das erste Bild ist das Basis-Bild. Die weiteren Bilder sind zusätzliche Referenzen, die den Edit konditionieren.
Der öffentliche Endpoint hat keinen Masken-Kanal. Zusätzliche Bilder wirken als Referenzen über das gesamte Bild, nicht als Regionsmasken – es gibt keinen
mask-Parameter, und das Senden eines solchen gibt einen 400 zurück. Prompte präzise, um einzugrenzen, wo der Edit landet.- 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
/image/background-remove verwendet ein festes internes Modell. Es akzeptiert kein model-Feld. Wird eines gesendet (zum Beispiel "model": "bria-bg-remover"), gibt es 400 invalid model id zurück.Adult-Inhalte und Safe Mode
Sowohl/image/edit als auch /image/multi-edit akzeptieren safe_mode (Default: true). Wenn aktiviert, werden Adult-Inhalte in der bearbeiteten Ausgabe unscharf gemacht. Setze safe_mode: false, um die Ausgabe ohne Unschärfe zu erhalten:
qwen-edit blockiert weiterhin explizite sexuelle Bilder und reale Gewalt – unabhängig von safe_mode. Für unzensiertes Editing nutze qwen-edit-uncensored.
Der Unterschied im Namen des Moderations-Feldes zwischen den Endpoints stiftet oft Verwirrung:
Wird
safe_mode an /images/generations übergeben, gibt es einen 400 mit Unrecognized key(s) in object: 'safe_mode'.
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.