Skip to main content
Die Bildbearbeitung auf Venice ist synchron. Sende dein Quellbild an /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.
Die Image-Edit-Endpoints sind experimentell, und modellspezifisches Verhalten kann sich im Laufe der Zeit ändern.

Endpoints

Wann welcher Endpoint?

  • /image/edit verwenden, wenn du ein Quellbild hast und einen Teil davon per Prompt verändern, entfernen oder umstilen willst.
  • /image/multi-edit verwenden, wenn du zusätzliche Kontrolle durch Masken, Overlays oder Referenz-Layer brauchst.
  • /image/background-remove verwenden, 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.
Setze enhance_prompt: true auf einem der Edit-Endpoints, damit ein Vision-fähiger Enhancer das Eingabebild oder die Eingabebilder analysiert und deine Anweisung vor der Bearbeitung umschreibt. Siehe Prompt-Enhancement für Verhalten, Preise und Details zu Response-Headern.

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:
Antwort (200): Der Response-Body sind rohe 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
JSON-Request:
Multipart-Request:
Wie bei /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 tree
  • change the sky to sunset
  • replace the logo with a blank sign
  • restore the torn corner of the photo
Für umfangreichere Szenenänderungen beschreibe, was unverändert bleiben soll:
Wenn der Edit ständig den falschen Bereich trifft, wechsle von /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:
Per lokalem Datei-Upload:
Hintergrundentfernung eignet sich für:
  • 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 ist qwen-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:

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