GPT Image 2.5 API

OpenAI GPT Image 2.5 in two variants: Sunburst for premium reference-faithful renders and edits, Flare for the same quality tier at half the latency. Up to 4K output, optional reference images and masks. Integrate this model via REST with endpoint docs, parameters, and code examples.

Prompting guide Compare image models Use cases

Image Generation

Img2Img

Editing

Credit Cost

2 credits

Type

Image

Get API Key

Create auth keys for apps and agents

See Usage

Track requests, credits, and logs

Buy Credits

Top up prepaid API capacity

API Endpoint

POST

/api/v1/models/gpt-image-2-5/run

Test This Model

Run a real request through the API pipeline and inspect the exact input and output your integration will handle. Uses your credits like any API call; failed runs are refunded automatically.

LLM.txt

AI-Ready

For AI assistants

Copy this model's documentation into Claude, GPT, or any AI for instant integration help.

/llm/gpt-image-2-5.txt

OpenAPI Spec

Swagger compatible

Import into Postman, Swagger UI, or generate client SDKs in any language.

/api/openapi

Parameters

Input parameters accepted by this model

Parameter	Type	Description	Default
`prompt` required	string	Text description of the image to generate, or the edit instruction when image_urls is supplied	-
`model`	enum	GPT Image 2.5 variant. "sunburst" is the premium model (strongest reference preservation and layout handling); "flare" is the fast model at roughly half the latency. `sunburstflare`	`sunburst`
`image_urls`	array	Optional reference image URLs (up to 8). With references the prompt is treated as an edit or composition instruction and each image costs 0.5 credits more; without them it is plain text-to-image. items: url min items: 1 \| max items: 8	-
`mask_url`	string	Optional inpainting mask, used together with image_urls. White marks the area to edit, black is preserved.	-
`image_size`	enum	Output image dimensions `1024x7681024x10241024x15361920x10882560x1440`+1 more	`1024x1024`
`quality`	enum	Generation quality tier. 4K outputs double the credit cost at medium and high. `lowmediumhigh`	`high`
`num_images`	integer	Number of images to generate (1-4) min: 1 \| max: 4	`1`
`output_format`	enum	Image output format `pngjpegwebp`	`png`

Supported Aspect Ratios

1:1

4:3

2:3

16:9

Code Examples

Generate image (Sunburst) — copy and paste to get started

bash

curl -X POST "https://pixeldojo.ai/api/v1/models/gpt-image-2-5/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a watercolor fox",
    "model": "sunburst",
    "quality": "high",
    "image_size": "1024x1024"
  }'

Response Format

Submit Response (202 Accepted)

json

{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 2,
  "creditsRemaining": 95,
  "expiresAt": "2026-09-16T09:33:28Z"
}

Completed Response