Beeldbewerking met GPT-Image-1

Gebruik POST /v1/images/edits met gpt-image-1 in CometAPI om afbeeldingen te bewerken via maskers, prompts en grootte-opties, in lijn met het OpenAI-gedrag voor beeldbewerking.

POST /v1/images/edits

Edit images

cURL

curl --request POST \
  --url https://api.cometapi.com/v1/images/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'prompt=Add a small red ribbon to the paper boat.' \
  --form image='@example-file' \
  --form mask='@example-file'

200

{
  "created": 1773381100,
  "usage": {
    "input_tokens": 226,
    "input_tokens_details": {
      "image_tokens": 194,
      "text_tokens": 32
    },
    "output_tokens": 4160,
    "total_tokens": 4386
  },
  "data": [
    {
      "b64_json": "<base64-image-data>"
    }
  ]
}

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

​

Eerste validatiepad

• Begin met één PNG- of JPG-bestand
• Sla het masker over totdat de basisstroom voor bewerking werkt
• Gebruik één korte instructie die om één zichtbare wijziging vraagt
• Verwacht een langere latency dan bij gewone beeldgeneratie

​

Modelgedrag

• gpt-image-1, gpt-image-1-mini en gpt-image-1.5 kun je het best behandelen als base64-first bewerkingsroutes
• dall-e-3 kan URL-uitvoer retourneren wanneer het providerpad dit ondersteunt
• qwen-image-edit volgt providerspecifiek bewerkingsgedrag achter dezelfde CometAPI-route

Live validatie op 2026-03-13 bevestigde dat een op PNG gebaseerde gpt-image-1-aanvraag slaagde wanneer een langere timeout was toegestaan. De response retourneerde usage.input_tokens, usage.output_tokens, usage.total_tokens en een data[0].b64_json payload.

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-1

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

mask · file

Optional PNG mask. Transparent areas indicate regions that should be edited.

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 output format when supported by the selected model.

Beschikbare opties: url, b64_json

size · string

Requested output size when supported by the selected model.

Respons

200 - application/json

Edited image result.

created · integer · vereist

data · object[] · vereist

Show child attributes

usage · object

Show child attributes