Edit an image
Submits an asynchronous image-to-image (editing) job to the fal.ai queue and returns the queued job immediately. Transforms one or more source images according to a text prompt — restyle a product photo, change a background, combine references. Poll GET /v1/jobs/{id} for status and results. Credits are charged only when the job completes successfully.
Authorizations
API key in the format: Bearer {api_token}
Headers
Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.
255Body
Model-specific input, forwarded to fal verbatim. prompt and a source image (image_url or image_urls) are required. For a featured model either image field is accepted and normalized to whichever that model expects; other models receive it as sent.
A quality tier (fast, balanced, quality) or any fal.ai image-to-image endpoint id. Prefer a tier — it tracks the best current model for that price point. Defaults to fal-ai/nano-banana/edit.
"fast"
"balanced"
"quality"
"fal-ai/bytedance/seedream/v4.5/edit"
"fal-ai/nano-banana-2/edit"
"openai/gpt-image-2.5/sunburst/edit"
"fal-ai/nano-banana/edit"
"fal-ai/nano-banana-pro/edit"
"fal-ai/flux-pro/kontext"
Response
Edit job queued
queued, processing, completed, failed, cancelled 
