Edit Images

Public model name gpt-image-2-auto, billed by returned image resolution, quality, and count, API reference to the call examples below, size options auto Billing mode: billed by the actual generated image size; async tasks reserve cost first and reconcile when results return

gpt-image-2-origin supported sizes

Billing mode: billed exactly by size

1K

Ratio	Landscape	Portrait	Orientation
4:3 / 3:4	1024x768, 1344x1024	768x1024, 1024x1344	Landscape / Portrait
5:4 / 4:5	1280x1024	1024x1280	Landscape / Portrait
16:9 / 9:16	1360x768, 1536x864	768x1360, 864x1536	Landscape / Portrait
1:1	1024x1024	-	Square
3:2 / 2:3	1536x1024	1024x1536	Landscape / Portrait
2:1 / 1:2	2048x1024	1024x2048	Landscape / Portrait
21:9 / 9:21	2016x864	864x2016	Landscape / Portrait

2K

Ratio	Landscape	Portrait	Orientation
16:9 / 9:16	1920x1080, 2048x1152, 2560x1440	1080x1920, 1152x2048, 1440x2560	Landscape / Portrait
1:1	1536x1536	-	Square
3:2 / 2:3	2048x1360, 2160x1440	1360x2048, 1440x2160	Landscape / Portrait
4:3 / 3:4	2048x1536	1536x2048	Landscape / Portrait
2:1 / 1:2	2688x1344	1344x2688	Landscape / Portrait
21:9 / 9:21	2688x1152	1152x2688	Landscape / Portrait
5:4 / 4:5	2560x2048	2048x2560	Landscape / Portrait

4K

Ratio	Landscape	Portrait	Orientation
1:1	2048x2048, 2880x2880	-	Square
4:3 / 3:4	3264x2448	2448x3264	Landscape / Portrait
3:2 / 2:3	3504x2336	2336x3504	Landscape / Portrait
2:1 / 1:2	3840x1920	1920x3840	Landscape / Portrait
21:9 / 9:21	3840x1648	1648x3840	Landscape / Portrait
16:9 / 9:16	3840x2160	2160x3840	Landscape / Portrait

API Parameters and Examples

Endpoint

POST /v1/images/edits/

Request Body Parameters

Field	Type	Required	Title	Description

Response Fields

Field	Type	Required	Title	Description

Response Examples

Example 1

{
  "created": 1777107492,
  "data": [
    {
      "url": "https://xxxxx.com/xxxx.png"
    }
  ]
}