Skip to content

GPT Image 2 API · Edit

Integrate

Model id openai/gpt-image-2/edit
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/openai/gpt-image-2/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

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

This request: ≈$0.222 222 API credits Run it on this page

Get API key
OpenAI Image Editing #gpt-image-2#openai#chatgpt-images-2

GPT Image 2 editing with up to 16 reference images and optional mask

Made on Doitong

Public works made with GPT Image 2 API by the Doitong community. Reuse a prompt in one click.

Public works shown: 16
Keep architecture unchanged. Photorealistic cinematic POV shot from a child riding a scooter thro...

Keep architecture unchanged. Photorealistic cinematic POV shot from a child riding a scooter through a modern residential park, clean late morning sunlight with soft upper side-backlight, ARRI Alexa 35, Leica Summilux-C 28mm lens, Black Pro Mist 1/8, subtle handheld inertia, natural optical...

Art style: Фотореалистичная семейная комедия, максимальный фотореализм, естественные движения мал...

Art style: Фотореалистичная семейная комедия, максимальный фотореализм, естественные движения малышей, выразительная мимика, кинематографическая съёмка, вирусный короткий визуальный юмор без диалогов. Внешность Лео и Мии сохраняется неизменной во всех сериях.. Лео и Мия сидят вместе на мягком...

Art style: Фотореалистичная семейная комедия, максимальный фотореализм, естественные движения мал...

Art style: Фотореалистичная семейная комедия, максимальный фотореализм, естественные движения малышей, выразительная мимика, кинематографическая съёмка, вирусный короткий визуальный юмор без диалогов. Внешность Лео и Мии сохраняется неизменной во всех сериях.. Лео наступает босой ногой на...

Крупный план рук пожилого мужчины, бережно держащего старый фотоальбом. Он медленно перелистывает...

Крупный план рук пожилого мужчины, бережно держащего старый фотоальбом. Он медленно перелистывает пожелтевшие страницы с выцветшими семейными фотографиями. Мягкий тёплый свет из окна, видимые детали возрастной кожи и фактуры потёртой обложки, пылинки в воздухе, спокойная камерная атмосфера,...

Создай реалистичную, тёплую семейную фотографию, используя обе загруженные фотографии как визуаль...

Создай реалистичную, тёплую семейную фотографию, используя обе загруженные фотографии как визуальные референсы для внешности людей и общего стиля. Изобрази бабушку в центре, а членов семьи вокруг неё — все нежно обнимают бабушку и друг друга, прижавшись плечами, с искренними улыбками и выражением...

Отредактируй загруженное изображение, сохранив стиль референса максимально точно: тот же шрифт и ...

Отредактируй загруженное изображение, сохранив стиль референса максимально точно: тот же шрифт и характер букв, цвет, оформление, композиционную эстетику и визуальное настроение. Добавь надпись именно на кириллице и ровно в таком написании: «Адрес: Төле би 40 / Самал 22А (7 мкр)». Размести весь...

Создай не меняя черты лица. Фотореалистичный винтажный cinematic portrait. В кадре большое наполь...

Создай не меняя черты лица. Фотореалистичный винтажный cinematic portrait. В кадре большое напольное зеркало в тонкой арочной раме. Спиной к камере у зеркала стоит взрослая девушка-, корпус развёрнут к своему отражению, голова слегка повёрнута в профиль, взгляд направлен в зеркало на свою...

Используй загруженное изображение как референс стиля и создай изображение с единственной надписью...

Используй загруженное изображение как референс стиля и создай изображение с единственной надписью: «YERSAY ӨНІМДЕРІ ТАРАЗ ҚАЛАСЫНДА». Напиши весь текст ровно в 2 строки: в первой строке слова «YERSAY ӨНІМДЕРІ» рядом друг с другом, во второй строке — «ТАРАЗ ҚАЛАСЫНДА». Сохрани максимально похожими...

Build a request

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

•required 88 / 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'.

num_images default 1

Count of images to produce.

Advanced mask · background · quality · output_format · enable_safety_checker
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.

quality default high

Image quality selection, including 'auto' for a prompt-dependent choice of the best quality by the model.

output_format default png

File format of the output images.

POST /run/openai/gpt-image-2/edit?wait=20 quote → $0.222
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/openai/gpt-image-2/edit?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "images": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/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 API · Edit

Edits or composes images from up to 16 URLs in `image_urls`, guided by a prompt of up to 32000 characters. A `mask_url` limits the edit to a region. `image_size` defaults to auto, which infers size from the inputs. Quality ranges from auto to high, with up to 4 outputs in png, jpeg or webp.

Parameters

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

NameType DefaultAllowed Description
promptrequired
Typestring
≤ 32,000 characters≥ 2 characters
Prompt used to generate images.
image_urlsrequired images
Typeurl[] · image
≤ 16 items
Reference image URLs for generation, limited to 16 images.
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
autolowmediumhigh
Image quality selection, including 'auto' for a prompt-dependent choice of the best quality by the model.
num_imagesoptional num_outputs
Typeinteger
Default1
1 – 4
Count of images to produce.
output_formatoptional
Typeenum
Defaultpng
jpegpngwebp
File format of the output images.
enable_safety_checkeroptional
Typeboolean
Defaulttrue
Screening can be relaxed by setting false, provided the caller is authorized.
mask_urloptional mask
Typeurl · image
URL for a mask image that identifies the region to edit during generation.
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/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": 222,
    "usd": "0.222",
    "charged": 222,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_urls": [
      "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
    ]
  },
  "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://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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/edit.md. All models and guides: https://doitong.com/developers/llms.txt