Skip to main content
POST
Gebruik deze route om bestaande afbeeldingen te bewerken met OpenAI-compatibele multipart uploads op CometAPI.

​
Gebruik deze route wanneer

  • Je al een bronafbeelding hebt en een Prompt-gestuurde bewerking wilt
  • Je mogelijk een masker nodig hebt voor gerichte wijzigingen
  • Je multipart-bestandsupload kunt verwerken in plaats van een gewone JSON-aanvraag

​
Veilige eerste aanvraag

  • Begin met één PNG- of JPG-bestand
  • Sla het masker over totdat de basisstroom voor bewerken werkt
  • Gebruik model: "gpt-image-2" voor GPT-afbeeldingsbewerkingsverzoeken op deze route
  • Gebruik één korte instructie die om één zichtbare wijziging vraagt
  • Lees het bewerkte resultaat uit data[0].b64_json
  • Stel output_format: "jpeg" in wanneer je een JPEG-payload wilt
  • Verwacht een hogere latentie dan bij gewone afbeeldingsgeneratie

​
Modelgedrag

  • GPT-afbeeldingsbewerkingsmodellen op deze route geven inline base64-afbeeldingsdata terug
  • output_format bepaalt het gecodeerde afbeeldingstype binnen b64_json
  • response_format is alleen van belang wanneer een model URL-uitvoer ondersteunt
  • qwen-image-edit volgt providerspecifiek bewerkingsgedrag achter dezelfde CometAPI-route

Autorisaties

​
Authorization
string
header
vereist

Bearer token authentication. Use your CometAPI key.

Body

multipart/form-data
​
image
file
vereist

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

​
prompt
string
vereist

Edit instruction describing the change you want.

Voorbeeld:

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

​
model
string
standaard: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
standaard:1

Number of edited images to return.

​
quality
enum<string>

Quality setting for models that support it.

Beschikbare opties:
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.

Beschikbare opties:
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.

Voorbeeld:

"jpeg"

​
size
string

Requested output size when supported by the selected model.

Respons

200 - application/json

Edited image result.

​
created
integer
vereist
​
usage
object
vereist
​
data
object[]
vereist
​
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.