GPT Image 2.5 API

Autenticación

All requests carry the API key in the header:

Authorization: Bearer YOUR_API_KEY

Pricing (per image, by resolution × quality)

quality accepts low, medium, high, xhigh and max, and **each tier is priced differently** — you pay for the detail you ask for: a layout check at 1K low is $0.008, and you only reach for max when the image is going to print. gpt-image-2.5-flare is the default tier (about half the latency of GPT Image 2 — social, e-commerce, high volume) and both renders and bills at **medium** unless you pass quality; gpt-image-2.5-sunburst targets premium commercial visuals and defaults to **high**, so pass quality explicitly if you do not want to be billed at the high rate. At the same quality tier the two models cost the same: you are choosing speed, not price. The resolution tier follows the longest edge of the image you actually get back, not the parameter you sent — with size auto or omitted the output decides, so pass an explicit size if you need a fixed tier. Reference images, mask and transparent background cost nothing extra; failed requests are not charged. gpt-image-2.5 is an alias of flare.

Sizes & billing tiers

Sizes are delivered exactly as requested (1024², 2048², 3840x2160 measured, no snapping). Alternatively omit size and pass aspect_ratio + resolution (1K/2K/4K) and the server derives the size.

Option 1: OpenAI SDK / Codex / Cursor (sync)

Passing an OpenAI-style WxH size triggers sync mode: the response carries the image inline (b64_json + url), matching the official images.generate() / images.edit() contract. Waiting and timeout rules are the same as GPT Image 2 All (280s cap, keep-alive after 95s; a failure after the 95s mark is carried in the body as an error field).

# Text-to-image — OpenAI Images API shape, SYNC response (no task polling)
curl -X POST https://api.apimodels.app/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "prompt": "a ceramic teapot, product shot, studio light",
    "size": "1024x1024",
    "background": "transparent",
    "output_format": "png",
    "n": 1
  }'
# → { "created": ..., "data": [{ "b64_json": "...", "url": "https://r2.apimodels.app/..." }] }

# Image edit — multipart, OpenAI images.edit() shape (mask is optional, must be a PNG the same size as image)
curl -X POST https://api.apimodels.app/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gpt-image-2.5-sunburst" \
  -F "image=@product.png" \
  -F "mask=@mask.png" \
  -F "prompt=change the red label to a green label, keep everything else exactly the same" \
  -F "size=2048x2048"

Option 2: native async (taskId + poll / callback)

Without a WxH size (or when you need callback_url) the request follows the platform async contract: create returns a taskId; poll until completed, or receive a webhook callback.

# Native async contract — pass aspect_ratio + resolution tier instead of size.
curl -X POST https://api.apimodels.app/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "prompt": "a lighthouse on a cliff at dusk",
    "aspect_ratio": "9:16",
    "resolution": "2K",
    "callback_url": "https://your-domain.com/webhook"
  }'
# → { "code": 200, "data": { "taskId": "..." } }

curl "https://api.apimodels.app/v1/images/generations?task_id=TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Parámetros

Notas

• Measured latency scales with quality: low about 30-45s, medium 40-70s, high about 50s at 1K, ~100s at 2K, ~70s at 4K; reference-image edits 15-50s. For sync calls set client timeouts to ≥180s.
• Outputs carry C2PA content credentials (genuine OpenAI pipeline).
• Upload size: requests through apimodels.app are capped at ~4.5MB per request body (413 beyond that). For large images or many references, switch base_url to https://api.apimodels.app/v1 — same API, same key, 100MB per request.
• Failed generations are not charged. Result files are auto-deleted after 7 days — download or re-host promptly.

Try it in the Playground