Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
OpenAI GPT Image 2 via the direct OpenAI Images API.
| Model id | gpt-image-2 |
| Media | image |
| Submit to | POST /v1/images |
| Price | 5 credits credits before discounts |
| Typical time | about 20.0 s |
promptgenerate_image_count, gpt_image_preset, gpt_image_size, image_background, mask_image, moderation, output_format, image_quality, reference_images
{
"model": "gpt-image-2",
"prompt": "Three-quarter character sheet of an Indian uncle in a cream kurta, clean forehead, soft studio key, seamless warm grey backdrop, photoreal, 50mm. No text.",
"generate_image_count": 1,
"gpt_image_preset": "1:1",
"gpt_image_size": "1024x1024",
"image_background": "opaque",
"moderation": "auto",
"output_format": "png",
"image_quality": "high"
}
| Field | Allowed | Default |
|---|---|---|
generate_image_count | 1.0 – 4.0 | 1 |
gpt_image_preset | 1:1, 3:2, 2:3, 16:9, 9:16, 4:3, 3:4, 21:9 | "1:1" |
gpt_image_size | 1536x864, 2048x1152, 3840x2160 | "1024x1024" |
image_background | opaque, auto | "opaque" |
mask_image | asset id (up to 1) | |
moderation | auto, low | "auto" |
output_format | png, webp, jpeg | "png" |
image_quality | high, medium, low | "high" |
reference_images | asset ids (up to 5) |
POST /v1/uploads or an earlier output’s asset_id.
Prices and allowed values come from the live catalog; GET /v1/models/gpt-image-2 is always current.