GPT Image 2.5 is LIVE — Flare & Sunburst | Try in Image Generator →
OpenAI·image·From $0.024/run

GPT Image 2.5 API

OpenAI GPT Image 2.5 — text-to-image and edit endpoints in two tiers, Flare (fast, balanced) and Sunburst (precision-focused), with five quality levels from low to max, 1K / 2K / 4K output, fifteen aspect ratios, and edits grounded in up to 16 reference images. Same request shape as GPT Image 2, lower per-image prices.

Four endpoints on one family: openai/gpt-image-2.5-flare and openai/gpt-image-2.5-sunburst, each with text-to-image and edit. Flare is the fast, balanced tier for everyday generation at low latency; Sunburst spends more time per image for extra fidelity on intricate detail. Both take the same parameters — quality (low / medium / high / xhigh / max), resolution (1k / 2k / 4k), fifteen aspect ratios from 1:3 to 3:1, and png / jpeg / webp output — and cost the same, from $0.01 per image.

GPT Image 2.5 sample output

About the GPT Image 2.5 API

What GPT Image 2.5 does, how it fits in the OpenAI model lineup, and why teams reach for it.

GPT Image 2.5 is a image generation and editing model from OpenAI, available through the WaveSpeedAI REST API. OpenAI GPT Image 2.5 — text-to-image and edit endpoints in two tiers, Flare (fast, balanced) and Sunburst (precision-focused), with five quality levels from low to max, 1K / 2K / 4K output, fifteen aspect ratios, and edits grounded in up to 16 reference images. Same request shape as GPT Image 2, lower per-image prices.

Four endpoints on one family: openai/gpt-image-2.5-flare and openai/gpt-image-2.5-sunburst, each with text-to-image and edit. Flare is the fast, balanced tier for everyday generation at low latency; Sunburst spends more time per image for extra fidelity on intricate detail. Both take the same parameters — quality (low / medium / high / xhigh / max), resolution (1k / 2k / 4k), fifteen aspect ratios from 1:3 to 3:1, and png / jpeg / webp output — and cost the same, from $0.01 per image.

The GPT Image 2.5 family on WaveSpeedAI ships 4 REST endpoints covering Image-To-Image, Text-To-Image workflows. Each variant carries its own pricing, parameter knobs, and example outputs — pick the one that matches your input modality and production constraints, or call several from the same API key to compose multi-step pipelines.

Run GPT Image 2.5 through the same API key, billing account, and rate-limit envelope you use for the other 1,000+ AI models on WaveSpeedAI. No separate vendor setup, no per-provider SDKs, no per-vendor rate-limit envelopes — one integration covers everything from text-to-image and text-to-video through audio synthesis, 3D generation, upscaling, and editing.

GPT Image 2.5 API capabilities and release status

The model-specific details developers search for before choosing an API: availability, expected output length, reference support, and the current live fallback.

Tiers

Flare / Sunburst

Flare for fast, balanced everyday generation; Sunburst for extra fidelity on intricate detail. Same price.

Quality levels

5

low / medium (default) / high / xhigh / max on every endpoint.

Resolution

1K / 2K / 4K

Same three tiers across text-to-image and edit.

Endpoints

4 variants

text-to-image and edit for each of Flare and Sunburst; edit takes up to 16 reference images.

All GPT Image 2.5 API endpoints

4 GPT Image 2.5 endpoints available now on WaveSpeedAI — pick the variant that matches your workflow.

Gpt Image 2.5 Sunburst Edit — GPT Image 2.5 image-to-image preview from OpenAI

Gpt Image 2.5 Sunburst Edit

OpenAI's GPT Image 2.5 Sunburst Edit edits one or more reference images from natural-language instructions, with five quality tiers up to 4K. Sunburst is the precision-focused GPT Image 2.5 tier that spends more time per image for extra fidelity on intricate detail. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

image-to-imagefrom $0.039
Gpt Image 2.5 Sunburst Text To Image — GPT Image 2.5 text-to-image preview from OpenAI

Gpt Image 2.5 Sunburst Text To Image

OpenAI's GPT Image 2.5 Sunburst Text-to-Image generates high-quality images from natural-language prompts, with five quality tiers up to 4K. Sunburst is the precision-focused GPT Image 2.5 tier that spends more time per image for extra fidelity on intricate detail. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

text-to-imagefrom $0.024
Gpt Image 2.5 Flare Edit — GPT Image 2.5 image-to-image preview from OpenAI

Gpt Image 2.5 Flare Edit

OpenAI's GPT Image 2.5 Flare Edit edits one or more reference images from natural-language instructions, with five quality tiers up to 4K. Flare is the fast, balanced GPT Image 2.5 tier for everyday generation at low latency. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

image-to-imagefrom $0.039
Gpt Image 2.5 Flare Text To Image — GPT Image 2.5 text-to-image preview from OpenAI

Gpt Image 2.5 Flare Text To Image

OpenAI's GPT Image 2.5 Flare Text-to-Image generates high-quality images from natural-language prompts, with five quality tiers up to 4K. Flare is the fast, balanced GPT Image 2.5 tier for everyday generation at low latency. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

text-to-imagefrom $0.024

See GPT Image 2.5 in action

Real outputs generated by the GPT Image 2.5 API. Hover any video to preview, click to open the full-size viewer.

How to use the GPT Image 2.5 API

Four steps from signup to a finished generation. Full Python, Node.js, and cURL examples are in the API section below.

  1. 1

    Get an API key

    Sign up for a WaveSpeedAI account and copy your API key from the dashboard. New accounts come with free starter credits — enough to run the playground a few dozen times before billing kicks in.

  2. 2

    Submit a prediction

    POST your input as JSON to https://api.wavespeed.ai/api/v3/openai/gpt-image-2.5-flare/text-to-image. The endpoint returns a prediction id immediately — generations are async so you don't hold an open connection during inference.

  3. 3

    Poll for completion

    GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Return outputs on completed; stop with an error on failed, cancelled, timeout, or deleted; continue polling for every other status.

  4. 4

    Read the output URL

    Once status is"completed", read the URL from data.outputs[0]. The URL points to your generated media on the WaveSpeedAI CDN — image, video, audio, or 3D file depending on the GPT Image 2.5 variant you called.

What you can build with GPT Image 2.5

Common workflows developers and creators use the GPT Image 2.5 API for.

Flare for speed, Sunburst for fidelity

openai/gpt-image-2.5-flare/text-to-image is the everyday tier: fast turnaround for drafts, social assets, and high-volume pipelines. openai/gpt-image-2.5-sunburst/text-to-image spends longer per image and holds up better on intricate detail — mechanical parts, fabric, small typography, dense scenes. Same prompt, same price; switching is a model-ID change.

flaresunbursttiers

Five quality levels on one knob

The quality parameter runs low / medium / high / xhigh / max. Medium is the default and the sweet spot for production work at $0.024 per 1K image; low is a draft tier at $0.01; high, xhigh, and max add detail for hero and print assets. Every tier is priced below the GPT Image 2 tier of the same name.

qualitytieredcost

Edit with up to 16 reference images

openai/gpt-image-2.5-flare/edit and openai/gpt-image-2.5-sunburst/edit take a plain-language instruction plus up to 16 reference images. Move a product into a new scene, change lighting or styling, or rework an existing brand asset while keeping the subject intact. The output follows the first reference image's aspect ratio unless aspect_ratio is set.

editreferenceinstruction

Up to 4K and fifteen aspect ratios

Every endpoint renders at 1k, 2k, or 4k and accepts fifteen aspect ratios — 1:1, 3:2, 2:3, 4:3, 3:4, 4:5, 5:4, 16:9, 9:16, 21:9, 9:21, 2:1, 1:2, 3:1, 1:3 — so the same prompt serves a square feed post, a 16:9 hero, and a 3:1 panorama banner without cropping in post.

4kaspect-ratiodelivery

Iterate cheaply, deliver once

Explore prompt direction at low quality and 1k for a cent an image, settle the composition at medium, then re-run the final prompt at the quality and resolution the deliverable needs. The request shape does not change between tiers, so the iteration loop is a two-field edit.

iterationcostworkflow

Drop-in migration from GPT Image 2

GPT Image 2.5 keeps the GPT Image 2 request format: prompt, images, aspect_ratio, resolution, quality, output_format. Point existing code at openai/gpt-image-2.5-flare/text-to-image or /edit, re-check the quality tier you send against your own outputs, and you are done. GPT Image 2 remains available alongside.

migrationgpt-image-2compatibility

Tips for prompting GPT Image 2.5

Practical advice for getting better outputs from GPT Image 2.5 — drawn from the patterns that work across image models in production pipelines.

Start on Flare, promote to Sunburst

Flare is the fast tier and the right default for iteration and volume. Re-run only the shots that need it on Sunburst — intricate mechanical detail, fabric texture, small typography — since the two tiers take identical parameters and cost the same.

Re-tune the quality tier after migrating

GPT Image 2.5 uses a five-step quality scale, not a renaming of GPT Image 2's three. Start at medium, compare against your existing outputs on the same prompts, and move one tier up if the result looks softer than before or one down if it costs more than expected.

Draft at low / 1k, deliver at the tier you need

low quality at 1k costs a cent per image, which makes prompt exploration essentially free. Lock the composition there, then re-run the final prompt at medium or high and at the delivery resolution.

Use the Edit endpoint with reference images

openai/gpt-image-2.5-flare/edit and the Sunburst equivalent accept up to 16 reference images plus an instruction. Describe what must stay unchanged as explicitly as what should change; the output follows the first image's aspect ratio unless you set one.

Keep brands and logos out of product shots

Ask for an unbranded item with a plain label when you want a clean product mockup; the model will otherwise happily invent a real-looking brand mark that you cannot use.

GPT Image 2.5 API pricing

Pricing is per-output. The final charge scales with the parameters you set in each variant's playground (resolution, duration, output count, references).

EndpointTypeStarting price
openai/gpt-image-2.5-sunburst/editimage-to-image$0.039
openai/gpt-image-2.5-sunburst/text-to-imagetext-to-image$0.024
openai/gpt-image-2.5-flare/editimage-to-image$0.039
openai/gpt-image-2.5-flare/text-to-imagetext-to-image$0.024

Call the GPT Image 2.5 API

Sign up for an API key at wavespeed.ai/accesskey, then submit a prediction via REST. The playground generates ready-to-paste samples for any combination of inputs.

HTTP example
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/openai/gpt-image-2.5-flare/text-to-image" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $WAVESPEED_API_KEY" \
  -d '{
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "aspect_ratio": "1:1",
    "resolution": "1k",
    "quality": "medium",
    "output_format": "png"
}')

TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
    -H "Authorization: Bearer $WAVESPEED_API_KEY")
  RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
  STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
  case "$STATUS" in
    completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
    failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
    *) sleep 2 ;;
  esac
done
Node.js example
const submitUrl = "https://api.wavespeed.ai/api/v3/openai/gpt-image-2.5-flare/text-to-image";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');

async function requestJson(url, options = {}) {
  const response = await fetch(url, options);
  if (!response.ok) throw new Error(await response.text());
  return response.json();
}

// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
        "prompt": "A cinematic shot of a city at sunset, soft golden light",
        "aspect_ratio": "1:1",
        "resolution": "1k",
        "quality": "medium",
        "output_format": "png"
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;

// 2. Poll until the prediction finishes.
while (true) {
  const resultBody = await requestJson(resultUrl, {
    headers: { "Authorization": `Bearer ${apiKey}` },
  });
  const result = resultBody.data ?? resultBody;
  if (result.status === "completed") {
    console.log(result.outputs);
    break;
  }
  if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
  await new Promise(resolve => setTimeout(resolve, 2000));
}
Python example
import json
import os
import time
from urllib.request import Request, urlopen

api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
    "prompt": "A cinematic shot of a city at sunset, soft golden light",
    "aspect_ratio": "1:1",
    "resolution": "1k",
    "quality": "medium",
    "output_format": "png"
}

def request_json(url, data=None):
    request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
    with urlopen(request) as response:
        return json.load(response)

# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/openai/gpt-image-2.5-flare/text-to-image", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"

# 2. Poll until the prediction finishes.
while True:
    result_body = request_json(result_url)
    result = result_body.get("data", result_body)
    status = result.get("status")
    if status == "completed":
        print(result.get("outputs", []))
        break
    if status in {"failed", "cancelled", "timeout", "deleted"}:
        raise RuntimeError(result)
    time.sleep(2)

GPT Image 2.5 vs alternatives

When to pick GPT Image 2.5 over similar models on WaveSpeedAI.

GPT Image 2.5 vs GPT Image 2

GPT Image 2.5 adds the Flare / Sunburst split, two more quality levels (xhigh and max), and lower prices at every tier — medium starts at $0.024 per image against $0.06 for GPT Image 2 medium, although 2.5 high is the closer match in fidelity to 2 medium. GPT Image 2 stays live; both share the same parameters.

GPT Image 2.5 vs Nano Banana 2

Nano Banana 2 ships multi-character consistency for up to 5 characters and optional web-search grounding. GPT Image 2.5 answers with five explicit quality tiers, a Sunburst tier for intricate detail, 4K output, and an edit endpoint that accepts up to 16 reference images.

GPT Image 2.5 vs Seedream 5

Seedream 5 Pro leads on information-dense layouts, interactive precision editing, and layer separation. GPT Image 2.5 is the pick for prompt-faithful photography and text rendering with a simple quality knob, and its low and medium tiers undercut Seedream 5 Pro on price for volume work.

GPT Image 2.5 API — Frequently asked questions

Pricing, license, integration — common questions about running GPT Image 2.5 on WaveSpeedAI.

What is the difference between GPT Image 2.5 Flare and Sunburst?

Flare is the fast, balanced tier for everyday generation at low latency. Sunburst is the precision-focused tier that spends more time per image for extra fidelity on intricate detail. They take identical parameters and cost the same, so you can switch by changing the model ID.

How much does GPT Image 2.5 cost?

Text-to-image is priced per image by quality and resolution: low $0.01 / $0.02 / $0.03, medium $0.024 / $0.04 / $0.07, high $0.09 / $0.15 / $0.27, xhigh $0.16 / $0.27 / $0.48, and max $0.36 / $0.60 / $1.00 at 1K / 2K / 4K. Edit adds $0.015 per image, plus $0.015 for each reference image beyond the first. Flare and Sunburst share the same prices.

How do GPT Image 2.5 quality tiers compare with GPT Image 2?

GPT Image 2.5 has five tiers (low, medium, high, xhigh, max) where GPT Image 2 has three, and each tier is priced below the GPT Image 2 tier of the same name: medium is $0.024 per 1K image against $0.06. The tiers are not defined as equivalents of GPT Image 2 tiers, so compare outputs on your own prompts and move one step up or down from medium as needed.

How many reference images does GPT Image 2.5 edit accept?

Up to 16 per request. The output keeps the aspect ratio of the first reference image unless you set aspect_ratio explicitly.

Is GPT Image 2 still available?

Yes. openai/gpt-image-2/text-to-image and openai/gpt-image-2/edit remain live alongside GPT Image 2.5, so existing pipelines can migrate on their own schedule.

What is the GPT Image 2.5 API?

GPT Image 2.5 is a OpenAI image generation model exposed as a REST API on WaveSpeedAI. OpenAI GPT Image 2.5 — text-to-image and edit endpoints in two tiers, Flare (fast, balanced) and Sunburst (precision-focused), with five quality levels from low to max, 1K / 2K / 4K output, fifteen aspect ratios, and edits grounded in up to 16 reference images. Same request shape as GPT Image 2, lower per-image prices. You can call it programmatically or try it from the playground linked above.

How do I call the GPT Image 2.5 API?

Sign up for a WaveSpeedAI account, copy your API key from /accesskey, then POST to https://api.wavespeed.ai/api/v3/openai/gpt-image-2.5-flare/text-to-image with your input as JSON. The endpoint returns a prediction id. Poll the result endpoint starting around every 2 seconds, increase the interval for long-running tasks, and stop on any terminal status. Production-oriented Python / Node.js / cURL examples are above.

How much does the GPT Image 2.5 API cost?

GPT Image 2.5 starts at $0.024 per run. The exact cost scales with the parameters you set (resolution, duration, output count, references). The live cost preview next to the Generate button in the playground shows the exact price for your current input.

Which GPT Image 2.5 variants are available?

WaveSpeedAI hosts 4 live GPT Image 2.5 endpoints: openai/gpt-image-2.5-sunburst/edit, openai/gpt-image-2.5-sunburst/text-to-image, openai/gpt-image-2.5-flare/edit, openai/gpt-image-2.5-flare/text-to-image. Each variant has its own playground page and pricing.

Can I use GPT Image 2.5 outputs commercially?

Commercial usage rights follow the OpenAI model license. Most OpenAI models permit commercial output use; see each model's playground page for the specific license summary, and WaveSpeedAI's Terms of Service for platform-level conditions.

Why use GPT Image 2.5 on WaveSpeedAI instead of going direct?

One API key + one billing account across GPT Image 2.5 AND 1,000+ other AI models from other providers. No per-vendor SDK setup, no separate rate-limit envelopes, no rewrite-per-vendor integration code. Pricing is typically at parity with or below OpenAI's direct API.

About OpenAI

The team behind GPT Image 2.5 and the broader OpenAI model lineup on WaveSpeedAI.

OpenAI is the lab behind ChatGPT, GPT-4 and GPT-5, DALL·E, Sora, and Whisper. Its image and video models are deployed widely across consumer and enterprise applications, with a focus on instruction-following, photorealism, and conservative safety guardrails. The image API is a frequent pick for marketing and editorial use cases that need strict commercial-use clarity.

Start building with GPT Image 2.5 on WaveSpeedAI

Free starter credits on signup. One API key across 1,000+ AI models from OpenAI and every other provider.

GPT Image 2.5 API — Flare & Sunburst AI Image Generation | WaveSpeedAI