Skip to main content
POST
Verwenden Sie diese Route, um vorhandene Bilder mit OpenAI-kompatiblen Multipart-Uploads in CometAPI zu bearbeiten.

​
Verwenden Sie diese Route, wenn

  • Sie bereits ein Quellbild haben und eine Prompt-gesteuerte Bearbeitung möchten
  • Sie möglicherweise eine Maske für gezielte Änderungen benötigen
  • Sie Multipart-Datei-Uploads anstelle einer einfachen JSON-Anfrage verarbeiten können

​
Sichere erste Anfrage

  • Beginnen Sie mit einer PNG- oder JPG-Datei
  • Lassen Sie die Maske weg, bis der grundlegende Bearbeitungsablauf funktioniert
  • Verwenden Sie model: "gpt-image-2" für GPT-Bildbearbeitungsanfragen auf dieser Route
  • Verwenden Sie eine kurze Anweisung, die um eine sichtbare Änderung bittet
  • Lesen Sie das bearbeitete Ergebnis aus data[0].b64_json
  • Setzen Sie output_format: "jpeg", wenn Sie eine JPEG-Nutzlast möchten
  • Rechnen Sie mit längerer Latenz als bei der einfachen Bildgenerierung

​
Modellverhalten

  • GPT-Bildbearbeitungsmodelle auf dieser Route geben eingebettete base64-Bilddaten zurück
  • output_format steuert den codierten Bildtyp innerhalb von b64_json
  • response_format ist nur relevant, wenn ein Modell URL-Ausgabe unterstützt
  • qwen-image-edit folgt anbieterspezifischem Bearbeitungsverhalten hinter derselben CometAPI-Route

Autorisierungen

​
Authorization
string
header
erforderlich

Bearer token authentication. Use your CometAPI key.

Body

multipart/form-data
​
image
file
erforderlich

Source image file. Start with one PNG or JPG input for the simplest flow.

​
prompt
string
erforderlich

Edit instruction describing the change you want.

Beispiel:

"Add a small red ribbon to the paper boat."

​
model
string
Standard:gpt-image-2

The image editing model to use. Choose a supported model from the Models page.

​
mask
file

Optional PNG mask. Transparent areas mark the regions to edit. The mask dimensions must match the source image exactly.

​
n
string
Standard:1

Number of edited images to return.

​
quality
enum<string>

Quality setting for models that support it.

Verfügbare Optionen:
high,
medium,
low
​
response_format
enum<string>

Requested response container when supported by the selected model. GPT image edit models return data[].b64_json; use output_format to choose the encoded image type.

Verfügbare Optionen:
url,
b64_json
​
output_format
string

Encoded image type for GPT image edit results returned in data[].b64_json. For example, use jpeg for a JPEG payload.

Beispiel:

"jpeg"

​
size
string

Requested output size when supported by the selected model.

Antwort

200 - application/json

Edited image result.

​
created
integer
erforderlich
​
usage
object
erforderlich
​
data
object[]
erforderlich
​
background
string

Background mode returned by models that expose it.

​
output_format
string

Encoded image type returned by GPT image models.

​
quality
string

Quality level returned by models that expose it.

​
size
string

Output size returned by models that expose it.