Skip to content

GPT Image 2.5 Edit

Integrate

Model id openai/gpt-image-2.5/flare/edit
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/openai/gpt-image-2.5/flare/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Same sneaker, but on a snowy mountain trail in daylight",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_sneaker_ad.jpg"
    ],
    "quality": "medium"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

This request: ≈$0.12 120 API credits Run it on this page

Get API key
OpenAI Image Editing #editing#mask#transparent

Edit or combine up to 16 reference images with OpenAI's image model, with optional mask and transparency.

OpenAI · Image

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

•required 55 / 32000

Prompt used to generate images.

•required image_urls
Drop a file, or · up to 16

Reference image URLs for generation, limited to 16 images.

image_size default auto

Output dimensions, inferred from the supplied images when set to 'auto'.

quality

Image quality selection, with 'auto' delegating the decision to the model. Additional detail at higher settings comes with longer latency and greater token usage.

num_images default 1

Count of images to produce.

Advanced mask · background · output_format · output_compression
mask_url
Drop a file, or

URL for a mask image that identifies the region to edit during generation.

background default auto

Background of the resulting image.

output_format default png

File format of the output images.

Compression setting available only for 'jpeg' or 'webp' in output_format; its permitted range is 0–100.

POST /run/openai/gpt-image-2.5/flare/edit?wait=20 quote → $0.12
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://vit.doitong.com/api/v1/run/openai/gpt-image-2.5/flare/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Same sneaker, but on a snowy mountain trail in daylight",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_sneaker_ad.jpg"
    ],
    "quality": "medium"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://vit.doitong.com/api/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About GPT Image 2.5 Edit

The editing mode of GPT Image 2.5: describe the change and pass up to 16 reference images, optionally with a mask that limits where the model may paint. Supports transparent backgrounds, five quality levels and up to ten results per request.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
promptrequired
Typestring
≤ 32,000 characters
Prompt used to generate images.
image_urlsrequired images
Typeurl[] · image
≤ 16 items
Reference image URLs for generation, limited to 16 images.
mask_urloptional mask
Typeurl · image
URL for a mask image that identifies the region to edit during generation.
image_sizeoptional
Typeobject
Defaultauto
square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9auto
Output dimensions, inferred from the supplied images when set to 'auto'.
backgroundoptional
Typeenum
Defaultauto
autotransparentopaque
Background of the resulting image.
qualityoptional
Typeenum
Defaulthigh
autolowmediumhighxhighmax
Image quality selection, with 'auto' delegating the decision to the model. Additional detail at higher settings comes with longer latency and greater token usage.
num_imagesoptional num_outputs
Typeinteger
Default1
1 – 10
Count of images to produce.
output_formatoptional
Typeenum
Defaultpng
jpegpngwebp
File format of the output images.
output_compressionoptional
Typeinteger | null
0 – 100
Compression setting available only for 'jpeg' or 'webp' in output_format; its permitted range is 0–100.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "openai/gpt-image-2.5/flare/edit",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 120,
    "usd": "0.12",
    "charged": 120,
    "refunded": 0
  },
  "input": {
    "prompt": "Same sneaker, but on a snowy mountain trail in daylight",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_sneaker_ad.jpg"
    ],
    "quality": "medium"
  },
  "output": {
    "images": [
      {
        "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
        "content_type": "image/jpeg",
        "file_name": "0-output.jpeg",
        "file_size": 1843200,
        "width": 1024,
        "height": 768
      }
    ]
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://vit.doitong.com/api/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
images
array of object {url, content_type, file_name, file_size, width, height}Images produced by the model.

More models: Image Editing

For AI agents: this page as Markdown is at https://doitong.com/developers/models/openai/gpt-image-2.5/flare/edit.md. All models and guides: https://doitong.com/developers/llms.txt