Skip to main content
POST
Create image generation and wait

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
model
string
required
Allowed value: "gpt-image-2"
prompt
string
required
size
string

Accepts auto, a positive WIDTHxHEIGHT target, or ratio shorthand such as 16:9. Every non-auto target is mapped to the nearest official popular size: 1024x1024, 1536x1024, 1024x1536, 2048x2048, 2048x1152, 3840x2160, or 2160x3840.

Examples:

"auto"

"1024x1024"

"1280x720"

"16:9"

quality
enum<string>
default:auto

GPT-Image 2 rendering quality.

Available options:
auto,
low,
medium,
high
n
integer
default:1

Number of images to generate. Billing scales with the image count.

Required range: 1 <= x <= 10
aspect_ratio
string
deprecated

Deprecated ratio shorthand. The ratio and compatibility tier are mapped to the nearest official popular size.

resolution
enum<string>
deprecated

Deprecated compatibility tier used to form the target size before nearest-official-size mapping.

Available options:
1K,
2K,
4K
input_images
string<uri>[]
callback_url
string<uri>

Response

OpenAI-compatible image generation result.

created
integer
required
data
object[]
required
usage
object