Model API

GPT Image 2.5 Flare

Precise image editing that changes only what's asked, keeping subject, composition, and background intact, with reference subjects staying recognizable across styles and successive edits.

Model id

Use this in every request

openai/gpt-image-2.5/flare/edit

This model has other modes with their own ids: openai/gpt-image-2.5/flare/text-to-image.

Run it

Quote the input, start the generation with the quote, then poll the job. Set RAYWAKE_API_KEY first; see Authentication.

# 1. Price the exact input (quotes are valid for up to 10 minutes)
curl -s https://api.raywake.com/v1/quotes \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "openai/gpt-image-2.5/flare/edit",
  "input": {
    "prompt": "A red ceramic cup on a wooden table, soft morning light",
    "image_urls": [
      "https://example.com/input.png"
    ]
  }
}'

# 2. Start the generation with the quote_id from step 1
curl -s https://api.raywake.com/v1/generate \
  -H "Authorization: Bearer $RAYWAKE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"model": "openai/gpt-image-2.5/flare/edit", "quote_id": "QUOTE_ID", "input": {"prompt":"A red ceramic cup on a wooden table, soft morning light","image_urls":["https://example.com/input.png"]}}'

# 3. Poll until the status is terminal
curl -s https://api.raywake.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $RAYWAKE_API_KEY"

Input

Input fields for openai/gpt-image-2.5/flare/edit
Name	Type	Description
`prompt`required	string	The prompt for image generation
`image_urls`required	array of image URLs	The URLs of the images to use as a reference for the generation. A maximum of 16 images are allowed.
`mask_url`	string (image URL)	Mask image URL. White marks regions to edit and black marks regions to keep.
`image_size`	string (enum)	The size of the generated image. Use 'auto' to infer from input images. Default: `auto` One of: `square_hd`, `square`, `portrait_4_3`, `portrait_16_9`, `landscape_4_3`, `landscape_16_9`, `auto`
`background`	string (enum)	Background for the generated image Default: `auto` One of: `auto`, `transparent`, `opaque`
`quality`	string (enum)	Quality for the generated image. Higher settings increase detail, latency, and token usage. Use 'auto' to let the model choose. Default: `high` One of: `auto`, `low`, `medium`, `high`, `xhigh`, `max`
`num_images`	integer	Number of images to generate Default: `1`
`output_format`	string (enum)	Output format for the images Default: `png` One of: `jpeg`, `png`, `webp`
`output_compression`	integer	Compression level from 0 to 100. Only supported when output_format is 'jpeg' or 'webp'.
`sync_mode`	boolean	If `True`, the media will be returned as a data URI and the output data won't be available in the request history. Default: `false`

Output

A succeeded job lists its results under outputs, stored on our side. See Jobs for every field.

Job excerpt

"outputs": [
  { "type": "image", "url": "https://…", "mime_type": "image/png", "thumbnail_url": "https://…" }
]

Pricing

auto · up to$0.72/ image
high · up to$0.24/ image
low · up to$0.10/ image
max · up to$0.72/ image
medium · up to$0.13/ image
xhigh · up to$0.37/ image

The exact charge for your input comes from a quote. How charges settle