GPT Image 2.5 – Flux1 AI API

OpenAI's latest image model. Sharp text and precise edits at 1K, 2K or 4K, with Flare for speed or Sunburst for precision.

GPT Image 2.5 concept preview — Concept artwork inspired by GPT Image 2.5.

OpenAIimage

Model id: gpt-image-2-5
Price: 1K 122K 164K 24credits / image
Output: 1K–4K
Reference images: Up to 16
Typical time: 30–60 seconds

Aspect ratios

auto1:116:99:164:33:43:22:35:44:521:9

Try GPT Image 2.5 in the web app

POST/api/v1/generations

JSON requestAsynchronousOne image per request

Pricing depends on resolution. Select a tier in the example to see the cost. Reference images do not add an extra charge. Check credits_refunded to confirm a refund; unresolved submissions may require review.

Jump to request examples ↓

Authorization

Authorizationstringrequired

Bearer fx1_live_… — send your API key in the request header. Requires a completed paid purchase; new generations also require enough credits.

Idempotency-Keystringoptional

Use one unique value per generation and reuse it with the same body on retries. Printable ASCII, no spaces. A different body with the same key returns 409.

Maximum length: 128 characters

Manage API keys ↗

Request body

modelstringrequired

Use this exact model ID in the top-level request body.

gpt-image-2-5

promptstringrequired

Describe the image to create, or the changes to make to your reference images. Whitespace is trimmed.

Maximum length: 5,000 characters

imagesstring[]optional

Optional reference images. Use publicly accessible HTTPS URLs or data:image/* base64 URIs (up to 20,000,000 characters per entry). Omit for text-to-image.

Maximum items: 16

aspect_ratiostringoptional

Output width-to-height ratio. Auto lets the model choose.

Default: auto

auto1:116:99:164:33:43:22:35:44:521:9

resolutionstringoptional

Output resolution tier; values are case-insensitive. Omit or leave empty to use the default.

Default: 1K

1K2K4K

versionstringoptional

flare is faster for everyday images and drafts; sunburst makes more precise edits. Both cost the same.

Default: flare

flaresunburst

Response & next step

A successful submission returns 202 and a generation id. Poll GET /api/v1/generations/{id} every 2–3 seconds until the status is succeeded or failed.

Read the result URL from output.images[0].url. Download it before expires_at (30 days after storage). On failure, inspect error and credits_refunded.

Generation lifecycle →Error reference →

Build your request

12 credits / image

ModeResolution

Examples only. Run on your server with your API key.

# Set FLUX1_IDEMPOTENCY_KEY once per generation; reuse it on retries.
curl --request POST 'https://flux1.ai/api/v1/generations' \
  --header "Authorization: Bearer $FLUX1_API_KEY" \
  --header 'Content-Type: application/json' \
  --header "Idempotency-Key: ${FLUX1_IDEMPOTENCY_KEY:?Set a unique key for this generation}" \
  --data '{
  "model": "gpt-image-2-5",
  "prompt": "A ceramic cup on a linen table, soft morning light",
  "aspect_ratio": "1:1",
  "resolution": "1K",
  "version": "flare"
}'

202 · POST /api/v1/generations

{
  "id": "gen_example",
  "status": "queued",
  "model": "gpt-image-2-5",
  "media_type": "image",
  "credits": 12,
  "credits_refunded": false,
  "input": {
    "prompt": "A ceramic cup on a linen table, soft morning light",
    "aspect_ratio": "1:1",
    "resolution": "1K",
    "version": "flare"
  },
  "output": null,
  "expires_at": null,
  "content_expired": false,
  "error": null,
  "created_at": "2026-09-07T08:00:00.000Z",
  "completed_at": null
}