fal.ai·Image editing

FLUX.1 Kontext [pro]

/fal-ai/flux-pro/kontextasync$0.08 / image

FLUX.1 Kontext [pro] handles both text and reference images as inputs, seamlessly enabling targeted, local edits and complex transformations of entire scenes. Returns hosted file URLs (download promptly; fal keeps them for a limited time). Billed per image.

Charged per image produced; a call that produces nothing is charged one unit.

Input

enhance_promptboolean
Whether to enhance the prompt for better results. (default false)
aspect_ratioany
The aspect ratio of the generated image.
guidance_scalenumber
The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you. (default 3.5)
safety_tolerancestring
The safety tolerance level for the generated image. 1 being the most strict and 5 being the most permissive. (default "2")
1, 2, 3, 4, 5, 6
seedany
The same seed and the same prompt given to the same version of the model will output the same image every time.
sync_modeboolean
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)
num_imagesinteger
The number of images to generate. (default 1)
output_formatstring
The format of the generated image. (default "jpeg")
jpeg, png
image_urlstringrequired
Image prompt for the omni model.
promptstringrequired
The prompt to generate an image from.

Field	Type	Required	Description
enhance_prompt	boolean	—	Whether to enhance the prompt for better results. (default false)
aspect_ratio	any	—	The aspect ratio of the generated image.
guidance_scale	number	—	The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you. (default 3.5)
safety_tolerance	string (1, 2, 3, 4, 5, 6)	—	The safety tolerance level for the generated image. 1 being the most strict and 5 being the most permissive. (default "2")
seed	any	—	The same seed and the same prompt given to the same version of the model will output the same image every time.
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)
num_images	integer	—	The number of images to generate. (default 1)
output_format	string (jpeg, png)	—	The format of the generated image. (default "jpeg")
image_url	string	yes	Image prompt for the omni model.
prompt	string	yes	The prompt to generate an image from.

Run it

curl -s https://sooma.dev/v1/run \ -H "Authorization: Bearer $SOOMA_API_KEY" \ -H "Content-Type: application/json" \ -d '{"provider":"fal","endpoint":"/fal-ai/flux-pro/kontext","input":{}}'

Or ask your agent: it will call inspect for this schema and run it over MCP.