GPT Image 2.5 Flare API

Introduction

GPT Image 2.5 Flare Edit runs OpenAI's gpt-image-2.5-flare on images you already have. It accepts one to sixteen sources, a PNG mask and a transparent-background option, and returns edits quickly enough for interactive use.

Choose a mode by starting material

Key features

Fast multi-source composites

Two or more sources become one scene with faces kept from their own images. Our two-source example finished in well under a minute.

Masks and cut-outs

A PNG mask limits the repaint to one area; background transparent returns a real alpha channel in PNG or WebP, ready for a layout without a keying step.

Several changes in one pass

Wardrobe, time of day and weather can change together, as long as the prompt also names what must stay the same. Our terrace example changed the dress and the light in one request.

Request parameters

Pricing

Prices are in credits, the same credits you use on the website (1 credit = $0.01). The hold is taken when the task is accepted and settled to the actual charge when it finishes; failed tasks are refunded.

Each task is rounded up to whole credits, so one run at the lowest tier costs 1 credit per image ($0.01).

For an exact number before you run, send the same body to POST /jobs/quote.

Use cases

Try-ons and restyles

Show the same person in a new outfit or a new place for a lookbook or a campaign draft, several options per request.

Pairing people from separate shots

Place two people photographed apart into one frame for a poster, a thumbnail or a story panel.

Seasonal refreshes

Turn a summer campaign image into an autumn or night version for the next season while the person and the product stay the same.

Prompt guide & pro tips

Give each source a job

The man and the doorway from the first image, the woman from the second: spell it out, because order is the only link between prompt and source.

Bundle related changes

A new dress and a new time of day read naturally in one request; unrelated changes are better as separate edits.

Mask background swaps

When only the background should change, keep the subject opaque and the background transparent in a PNG mask the size of the first source.

API quick start

Call the GPT Image 2.5 Flare API in three steps

1. Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow- and use the same credits as the website.
2. Send the request. POST /jobs/createTask with model openai/gpt-image-2.5-flare/edit and an input object that follows the parameter table. The response returns a task ID straight away.
3. Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "openai/gpt-image-2.5-flare/edit",
  "input": {
    "prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
    "image_urls": [
      "https://media.popnow.ai/influencer/examples/marco.webp"
    ],
    "aspect_ratio": "1:1",
    "resolution": "1k",
    "quality": "high",
    "num_outputs": 1,
    "input_fidelity": "low"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.

GPT Image 2.5 Flare API questions

All GPT Image models

GPT Image 2.5 Sunburst costs the same and takes longer, and it's the one to choose for final images and precise retouching. Flare is the choice when turnaround matters.

• GPT Image 2.5 Sunburst APIOpenAI's quality-first model, up to 4K with clean textFrom 1 credit per image
• GPT Image 2.5 Flare APIOpenAI's speed-first model with masked edits and cut-outsFrom 1 credit per image
• GPT Image 2 APILegible in-image text and precise masked editsFrom 1 credit per image

Other image APIs

• Nano Banana 2.1 APIGoogle's newest Nano Banana, sharp text and 4K outputFrom 8 credits per image
• Nano Banana Pro APIPlans the layout first: dense text, diagrams and 4K editsFrom 17 credits per image
• Seedream 5.0 Pro APIHigh-detail images and edits from up to ten referencesFrom 6 credits per image
• FLUX.2 Max APITop-tier FLUX: photoreal light and exact brand colorsFrom 11 credits per image
• Qwen Image 2.1 Pro APIUp to six detailed 2K images from one promptFrom 6 credits per image
• Qwen Image 2.1 Turbo APIFast 8-step renders, up to six per promptFrom 3 credits per image

More about GPT Image 2.5 Flare

Try it

GPT Image 2.5 Flare AI Image Generator onlineCreate images with GPT Image 2.5 Flare in PopNow

Docs

GPT Image 2.5 Flare model ID and input schema in the API docsPopNow API quickstart: your first request in five minutesImage generation guide for the PopNow APIWebhooks: get GPT Image 2.5 Flare results without polling