Spiral gives your agent every tool with one account. Browse the tools →

falImageAvailable nowReleased 2026-09-08

GPT Image 2.5 Flare · Image Editing

openai/gpt-image-2.5/flare/edit

Edit and enhance images with GPT Image 2.5 Flare · Image Editing from fal through one Spiral API key. Edits images from a text instruction with GPT Image 2.5 Flare, using up to 16 references, a mask and six quality levels. It runs in the background and returns images. Pay as you go, with no subscription.

Run time p50 · last 24 hours
23.2s
Success rate · last 24 hours
100.0%

Pricing

$0.0475 per 4:3 image at high quality ($0.00572 low, $0.0122 medium, $0.084 xhigh, $0.188 max). At high: $0.0605 square, $0.069 square HD, $0.0342 16:9. Auto quality or size: the price of the one chosen for the request. Prompt: $6.50 per 1M tokens. Input images: $0.0106 each at 1024×1024.

Limits

Runs
In the background
Returns
image
Longest queue wait
1 hour
Run deadline
30 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
prompt requiredtext—

The prompt for image generation

image_urls requiredURLs or files—

The URLs of the images to use as a reference for the generation. A maximum of 16 images are allowed.

mask_urlURL or file—

Mask image URL. Standard processing treats white as edit and black as keep. With image_passthrough or provider_options, supply an OpenAI-native PNG alpha mask: transparent regions are edited, and dimensions must match the first reference. The mask guides the edit but is not a hard boundary: the model redraws the whole image, so unmasked areas (faces, text) can change; composite the output over the original to keep them exactly.

image_sizeJSONauto

The size of the generated image. 'auto' matches the first image's size, except with image_passthrough, where it returns about 1.5 MP (e.g. 1536x1024); set width and height to keep the reference size. Explicit sizes need both sides as multiples of 16, a longest edge of at most 3840 px, an aspect ratio of at most 3:1, and 655,360 to 8,294,400 pixels.

backgroundone of
auto, transparent, opaque
auto

Background for the generated image

qualityone of
auto, low, medium, high, xhigh, max
high

Quality for the generated image. Higher settings increase detail, latency, and token usage. Use 'auto' to let the model choose.

num_imagesnumber (whole)
1 to 10
1

Number of images to generate

output_formatone of
jpeg, png, webp
png

Output format for the images

output_compressionnumber (whole)
0 to 100
—

Compression level from 0 to 100. Only supported when output_format is 'jpeg' or 'webp'.

image_passthroughtrue or falsefalse

Send reference images and masks without resizing or re-encoding, and return the provider's original image bytes and format. Requests use the direct OpenAI API. Masks must be PNGs with an alpha channel: transparent regions are edited, and dimensions must match the first reference.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "openai/gpt-image-2.5/flare/edit",
    "input": {
      "prompt": "Same workers, same beam, same lunch boxes - but they'\''re all on their phones now. One is taking a selfie. One is on a call looking annoyed. Same danger, new…",
      "image_urls": [
        "<image_urls>"
      ]
    }
  }'

Frequently asked questions

How much does GPT Image 2.5 Flare · Image Editing cost?

$0.0475 per 4:3 image at high quality ($0.00572 low, $0.0122 medium, $0.084 xhigh, $0.188 max). At high: $0.0605 square, $0.069 square HD, $0.0342 16:9. Auto quality or size: the price of the one chosen for the request. Prompt: $6.50 per 1M tokens. Input images: $0.0106 each at 1024×1024. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use GPT Image 2.5 Flare · Image Editing through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "openai/gpt-image-2.5/flare/edit"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with fal to use GPT Image 2.5 Flare · Image Editing?

No. Spiral runs it on its own fal account and charges your Spiral balance.

Can my AI agent use GPT Image 2.5 Flare · Image Editing?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.