Skip to content

Build6 publishers3 min readPublished

Multi-turn GPT Image 2.5 editing runs only through OpenAI's Responses API

OpenAI's guide names Sunburst for editing precision and Flare for speed, and both run from either API. The editing loop, File ID inputs and the action switch exist on the Responses side alone.

The Engineer · Build desk

Illustration accompanying Multi-turn GPT Image 2.5 editing runs only through OpenAI's Responses API

What happened

  • OpenAI's image generation guide names two models, gpt-image-2.5-sunburst for workflows where editing precision matters most and gpt-image-2.5-flare for fast, high-quality everyday generation.
  • The New Stack reports both models priced identically at $5 per million text input tokens, $8 per million image input tokens and $30 per million image output tokens.
  • OpenAI states that token rates match GPT Image 2 and that the GPT Image 2 calculator does not estimate GPT Image 2.5 token consumption.

Compiled by The EngineerSomething wrong?How this is made

Why it matters

  • decision Committing to the Image API today means rewriting both the request and the response parsing later if the product ever needs a second round of edits on the same image.
  • cost Anyone quoting a fixed price per generated image is exposed on margin until they have metered their own prompts, because the rate card alone cannot separate a Sunburst image from a Flare one.
  • constraint OpenAI's 50% latency claim is measured against GPT-Image-2, so it bounds a team's own gain only where that older model is the one being replaced at comparable size and quality settings.
  • exposure Pinning action to edit puts an error path in production that depends on whether the conversation still holds an image, while leaving it on auto hands that choice to the mainline model.

On the Image API you call client.images.generate with model set to gpt-image-2.5-sunburst, and the image comes back as base64 in result.data[0].b64_json [6]. On the Responses API you set a mainline model at the top level, the docs example uses gpt-6-astra, put the image model in the image_generation tool's model field, and then filter response.output for items whose type is image_generation_call [7][5]. Two model strings per request instead of one [22].

Single-shot editing works on both. The Image API has an Edits endpoint that modifies an existing image partially or entirely [2]. The Responses API adds iteration: multi-turn editing, and image File IDs accepted as inputs rather than only bytes [3]. Turn state comes from passing the image generation call output back in context, or from previous_response_id [8]. The guide's routing advice is direct: one image from one prompt, use the Image API; conversational, editable experiences, use the Responses API [4].

The tool's action parameter decides behaviour at runtime. Setting it to auto lets the model choose whether to generate a new image or edit one already in the conversation, generate always creates, and edit forces an edit when an image is in context [9]. Force edit with nothing in context and the call returns an error [10]. The guide documents that error as the expected result.

The docs do not settle pricing. The New Stack reports identical token rates for the two models [14], and OpenAI's note says "Token rates match GPT Image 2. The GPT Image 2 calculator does not estimate GPT Image 2.5 token consumption." [15]. According to The New Stack, there is no published guidance for estimating 2.5 consumption at all [16]. Image output at $30 per million tokens is 3 cents per thousand output tokens, so a 1,000-token render costs 3 cents and a 4,000-token one costs 12 cents [25]. Which of those you get comes out of a metered test run [21].

Treat the latency figure the same way. OpenAI says Flare delivers higher-quality images than GPT-Image-2 with 50% lower latency [17], and calls it "the default choice for most applications" [18]. That 50% bounds your own improvement only if GPT-Image-2 is what you are replacing, at your sizes, quality settings and prompt mix. Sunburst, which OpenAI describes as "built for premium visual workflows that benefit from tighter control across edits", comes with "longer generation times" per the launch announcement [19]. Per The New Stack, neither the announcement nor the model pages quantify that gap [20].

Quality, size, format and compression are adjustable from both APIs [12], so output settings do not decide this. The question is whether the product will ever want a second edit of the same image. If it might, write against the Responses API shape first, because switching later changes where the model is named and how the response is read [5][7].

What to watch

  • Per-image token counts or a GPT Image 2.5 calculator from OpenAI would make the Flare-versus-Sunburst cost comparison computable before a test run.
  • A published Flare-versus-Sunburst generation-time figure, or a latency claim measured against something other than GPT-Image-2.
  • Changes to the supported models list for mainline models that can call the image generation tool, which currently gates the Responses API path.
Loading claim ledger
Loading source directory links
Loading share composer
Loading topic controls
Loading related stories