Skip to main content
POST
GPT Image 2.6 Official
Flare and Sunburst with six quality options, planning effort, masks and annotation editing, billed by actual tokens. Model IDs: gpt-image-2.6-flare / gpt-image-2.6-sunburst.

Quick start

Read task_id after submission and poll GET /v1/tasks/{task_id}. Download files from result.images[].url[] on success. Continue polling the original task after a timeout; do not submit a duplicate.

Parameters

Reference editing

GIF animation

Both official routes support output_format: "gif" for text or reference-image generation. Defaults are 512×512, 9 frames and 200ms per frame. n counts animations, not frames.
Poll the same task endpoint and download the GIF from result.images[].url[]. Reservation uses the full sprite-sheet output token tier plus prompt and reference-input allowance for each animation. Settlement uses actual typed tokens within the hold and refunds the difference; it does not multiply a static-image price by frame count. For example, 512x512 / 9 frames / low reserves 1172 output tokens ($0.031644), plus prompt allowance. A real receipt used 68 text input + 1172 image output tokens and settled at $0.03195. This is an example receipt; obtain a fresh quote before submission.

Reference image to GIF

Both official variants accept up to 16 reference images. action: "edit" requires at least one image_urls entry; n=2 requests two complete animations. Input fees are reserved for every animation, then settled from the reported aggregate usage. References are not charged once per frame. GIF size describes one frame and does not follow the reference image aspect ratio.
Economy variants do not support reference-image GIFs.

Flare: 16-frame GIF from a reference

Flare reference GIF

Sunburst: 9-frame GIF from a reference

Sunburst reference GIF Native looping GIFs from the named models, verified for frame count, duration and downloadable output.

Billing

Charged by actual typed token usage, in USD per million tokens: Quotes reserve prompt, reference and output usage. quality: "auto" reserves max; successful tasks settle actual usage within the hold. Version 2.6 low/medium usage differs from 2.5, so request a new quote. Safety rejections may charge processed input, with no charge for ungenerated output. Unconfirmed cost or usage remains billing_status pending until reconciliation.

Limits

SVG and exact pixel sizes for static images are not exposed. GIF supports only the square frame sizes and qualities listed above. Reference-image GIFs are supported. Masks, annotations, compression and transparent backgrounds remain unavailable for GIF.