Skip to main content
POST
/
v1
/
images
/
edits
GPT Image Editing
curl --request POST \
  --url https://api.myrouter.ai/v1/images/edits \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "model": "<string>",
  "image": [
    null
  ],
  "prompt": "<string>",
  "quality": "<string>",
  "n": 123,
  "size": "<string>"
}
'
{
  "created": 123,
  "data": [
    {
      "b64_json": "<string>"
    }
  ],
  "usage": {
    "input_tokens": 123,
    "input_tokens_details": {
      "image_tokens": 123,
      "text_tokens": 123
    },
    "output_tokens": 123,
    "total_tokens": 123
  }
}
Use GPT image editing models to intelligently edit and modify existing images via text descriptions. Supports multiple image formats and quality options to meet various image editing needs.

Request Headers

Content-Type
string
required
Enum: application/json
Authorization
string
required
Bearer authentication format: Bearer {{API Key}}.

Request Body

model
string
required
The model used for image editing. Currently supports gpt-image-1, gpt-image-1.5.
image
file[]
required
Array of images to be edited (multipart/form-data).For gpt-image-1, gpt-image-1.5, each image must be in png, webp, or jpg format, under 50MB per image, with a maximum of 16 images.
prompt
string
required
Text description of the desired edited image.For gpt-image-1, gpt-image-1.5, the maximum length is 32000 characters.
quality
string
Quality of the generated image, Default: auto.For gpt-image-1, gpt-image-1.5, supported values are: auto, high, medium, low.
n
integer
Number of images to generate, Range: 1~10, Default: 1.
size
string
Size of the generated image, Default: auto.For gpt-image-1, gpt-image-1.5, supported values are:
  • 1024x1024: Square
  • 1536x1024: Landscape
  • 1024x1536: Portrait
  • auto: Default

Response Parameters

created
integer
required
Unix timestamp (in seconds) of when the image was generated.
data
array
required
List of generated images.
usage
object
Only supported by gpt-image-1, gpt-image-1.5. Token usage information for image generation.