Zum Hauptinhalt springen
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 Bilddatei 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

Venice bietet keinen OpenAI-kompatiblen /images/edits-Endpoint, daher geben OpenAI-SDK-Aufrufe wie client.images.edit() 404 zurück. Sende Edits stattdessen an /image/edit.

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 den Edit zusätzlich an weiteren Referenzbildern ausrichten willst.
  • /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 Bild-Binärdaten. Speichere sie direkt in eine Datei. Das Format ist PNG bei 1K-Edits und JPEG bei 2K- und 4K-Edits bzw. PNG bei jeder Auflösung, wenn transparent_background auf true steht. Setze output_format auf jpeg, png oder webp, um das Format explizit festzulegen. Die Edit-Endpoints haben keinen response_format-Parameter und können das Bild daher nicht als Base64-JSON zurückgeben. Wenn du Base64 brauchst, kodiere die Response-Bytes selbst.

Schritt 2: Multi-Edit mit Referenzbildern nutzen

/image/multi-edit akzeptiert mehrere Bilder, und die Obergrenze ist modellspezifisch. 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 bzw. bei 1, wenn combineImages auf false steht. 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 Regionskarten. Es gibt keinen mask-Parameter, und das Senden eines solchen gibt einen 400 zurück. Prompte präzise, um einzugrenzen, wo der Edit landet.
Das ist die bessere Wahl, wenn du:
  • eine bestehende Komposition mit einem zusätzlichen Referenzbild kombinieren willst
  • dem Modell Beispiele für den Stil, das Objekt oder die Textur geben willst, die angewendet werden sollen
  • 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 Bilddaten, und das Ausgabeformat folgt denselben Regeln.
/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, übergib ein zusätzliches Referenzbild, das das gewünschte Ergebnis zeigt, und beschreibe die beabsichtigte Änderung präzise im Prompt.

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
Wenn du das Bild ohnehin generierst oder bearbeitest, kannst du dir diesen zweiten Aufruf sparen: /image/generate, /image/edit und /image/multi-edit akzeptieren bei unterstützten Modellen transparent_background: true und liefern den Alphakanal direkt mit. Siehe Bilder mit transparentem Hintergrund für den Vergleich.

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 zurück, weil model kein erkanntes Feld ist.

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:
Nicht unscharfe Adult-Ausgaben (NSFW) stehen allen API-Nutzern zur Verfügung. Du brauchst kein Pro-Abo, und die Einstellung für den Filter für Inhalte für Erwachsene in der Venice-App hat keinen Einfluss auf Bildanfragen über die API. Die Inhaltsrichtlinien variieren je nach Edit-Modell und gelten 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 Bilder mindestens 256×256 Pixel groß sein, und die Gesamtpixelzahl darf 33.177.600 (8K-Auflösung) nicht überschreiten. Hochgeladene Dateien müssen kleiner als 25MB sein.

Modelle und Preise

Das Default-Edit-Modell ist firered-image-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. Anfragen, die gegen die Richtlinie des gewählten Modells verstoßen, werden mit 422 abgelehnt.

Verwandte Workflows