POST /api/v1/images/generations with model: gpt-image-2-5-sunburst and a prompt for text-to-image, or add up to 16 images in image_list to edit them. Price follows quality and image_size.GPT Image 2.5 Sunburst API for Precise Image Edits
GPT Image 2.5 Sunburst is OpenAI's GPT Image 2.5 tuned for editing precision, for workflows where edit fidelity matters most. Call
Get API Key
Generate, Edit and Cut Out in One Model
Edits from up to 16 references
Pass image_list as [{"url": "https://…"}] with up to 16 images, each under 50MB. With ratio: auto, the output follows the reference image's shape.
Transparent PNG cut-outs
Set background: transparent to keep the alpha channel for isolated product shots, icons and stickers. It does not change the price.
Long, detailed prompts
prompt accepts up to 32,000 characters; keep it under roughly 8,000 tokens for best results. ratio covers auto plus 15 fixed shapes from 1:3 to 3:1.
model and prompt are required; quality and image_size together set the price.
GPT Image 2.5 Sunburst Request Fields and Limits
model
Always <code>gpt-image-2-5-sunburst</code>.
prompt (required)
Up to 32,000 characters; keep it under roughly 8,000 tokens for best results.
image_list
Optional, 1 to 16 reference images to edit, each under 50MB, as <code>[{"url": "https://…"}]</code>.
quality and image_size
<code>quality</code>: <code>low</code> (default), <code>medium</code>, <code>high</code>, <code>xhigh</code> or <code>max</code>. <code>image_size</code>: <code>1k</code> (default), <code>2k</code> or <code>4k</code>.
ratio
<code>auto</code> (default; follows the reference when one is supplied), <code>1:1</code>, <code>1:2</code>, <code>2:1</code>, <code>1:3</code>, <code>3:1</code>, <code>2:3</code>, <code>3:2</code>, <code>3:4</code>, <code>4:3</code>, <code>4:5</code>, <code>5:4</code>, <code>9:16</code>, <code>16:9</code>, <code>9:21</code> or <code>21:9</code>.
background and custom_callback_url
<code>background</code> is <code>opaque</code> (default) or <code>transparent</code>. The optional callback URL receives the job-detail body on each status change.
Per image, by quality and resolution. Reference images and transparency add nothing.
GPT Image 2.5 Sunburst API Pricing
low: from 0.32 tokens ($0.0064)
1k 0.32 tokens ($0.0064), 2k 0.64 tokens ($0.0128), 4k 1.07 tokens ($0.0214). This is the default quality.
medium and high
Medium: 1k 0.71 tokens ($0.0142), 2k 1.45 tokens ($0.0290), 4k 2.4 tokens ($0.0480). High: 1k 2.84 tokens ($0.0568), 2k 5.78 tokens ($0.1156), 4k 9.61 tokens ($0.1922).
xhigh
1k 5.06 tokens ($0.1012), 2k 10.28 tokens ($0.2056), 4k 17.08 tokens ($0.3416).
max
1k 11.38 tokens ($0.2276), 2k 23.12 tokens ($0.4624), 4k 38.42 tokens ($0.7684).
Charged on acceptance, refunded on failure
The response's <code>cost</code> is the amount actually charged, including any account discount; failed jobs are refunded automatically.
Integrate the GPT Image 2.5 Sunburst API
2
2. Choose quality and size
Start at
quality: low and image_size: 1k while iterating, then raise either for final output. 3
3. Submit the job
POST
{"model": "gpt-image-2-5-sunburst", "prompt": "a glossy red sneaker, product shot, isolated subject", "background": "transparent"} to /api/v1/images/generations, adding image_list for edits. 4
4. Retrieve the result
Store the
img_uuid, poll GET /api/v1/jobs/detail or use a callback, and download the image within 24 hours of completion.Features where an edit should change what was asked and little else.
What Developers Build with GPT Image 2.5 Sunburst
Targeted photo edits
Apply instructions like recoloring an object or replacing a label to user photos where edit fidelity matters most.
Product cut-outs
Produce transparent PNG product shots for catalogs, marketplaces and compositing.
Multi-image compositions
Combine up to 16 references, such as products, logos supplied by the user and backgrounds, into one image.
Cost-tiered pipelines
Draft at <code>low</code> for 0.32 tokens ($0.0064) at 1k, then re-render approved images at <code>high</code> or above.
Editing, quality tiers and pricing.