v1

latestOpenAPI 3.1.02026-07-267724480.0 KB

Edit images

Upload one or more source images, optionally include a mask, and request an edited result with a text instruction.

post/v1/images/edits

Response

Edited image result.

createdinteger required

backgroundstring

Background mode returned by models that expose it.

output_formatstring

Encoded image type returned by GPT image models.

qualitystring

Quality level returned by models that expose it.

sizestring

Output size returned by models that expose it.

Example response

{
  "created": 1776836647,
  "usage": {
    "prompt_tokens": 0,
    "completion_tokens": 0,
    "total_tokens": 981,
    "prompt_tokens_details": {
      "cached_tokens_details": {}
    },
    "completion_tokens_details": {},
    "input_tokens": 785,
    "output_tokens": 196,
    "input_tokens_details": {
      "image_tokens": 768,
      "text_tokens": 17,
      "cached_tokens_details": {}
    },
    "claude_cache_creation_5_m_tokens": 0,
    "claude_cache_creation_1_h_tokens": 0
  },
  "data": [
    {
      "b64_json": "<base64-image-data>"
    }
  ]
}