Skip to main content
Endpoint: POST https://fal.run/fal-ai/flux-pro/kontext/multi Endpoint ID: fal-ai/flux-pro/kontext/multi

Try it in the Playground

Run this model interactively with your own prompts.

​
Quick Start

import fal_client

def on_queue_update(update):
    if isinstance(update, fal_client.InProgress):
        for log in update.logs:
           print(log["message"])

result = fal_client.subscribe(
    "fal-ai/flux-pro/kontext/multi",
    arguments={
        "prompt": "Put the little duckling on top of the woman's t-shirt.",
        "image_urls": [
            "https://v3.fal.media/files/penguin/XoW0qavfF-ahg-jX4BMyL_image.webp",
            "https://v3.fal.media/files/tiger/bml6YA7DWJXOigadvxk75_image.webp"
        ]
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

​
Capabilities

  • Text prompt input
  • Reproducible generation (seed)
  • CFG guidance scale
  • Synchronous mode
  • Batch generation
  • Aspect ratio control

​
API Reference

​
Input Schema

​
prompt
string
required
The prompt to generate an image from.
​
seed
integer
The same seed and the same prompt given to the same version of the model will output the same image every time.
​
guidance_scale
float
default:"3.5"
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 value: 3.5Range: 1 to 20
​
sync_mode
boolean
default:"false"
If True, the media will be returned as a data URI and the output data won’t be available in the request history.
​
num_images
integer
default:"1"
The number of images to generate. Default value: 1Range: 1 to 4
​
output_format
OutputFormatEnum
default:"jpeg"
The format of the generated image. Default value: "jpeg"Possible values: jpeg, png
​
safety_tolerance
SafetyToleranceEnum
default:"2"
The safety tolerance level for the generated image. 1 being the most strict and 5 being the most permissive. Default value: "2"Possible values: 1, 2, 3, 4, 5, 6
​
enhance_prompt
boolean
default:"false"
Whether to enhance the prompt for better results.
​
aspect_ratio
Enum
The aspect ratio of the generated image.Possible values: 21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:21
​
image_urls
list<string>
required
Image prompt for the omni model.

​
Output Schema

​
images
list<registry__image__fast_sdxl__models__Image>
required
The generated image files info.
​
timings
Timings
required
​
seed
integer
required
Seed of the generated Image. It will be the same value of the one passed in the input or the randomly generated that was used in case none was passed.
​
has_nsfw_concepts
list<boolean>
required
Whether the generated images contain NSFW concepts.
​
prompt
string
required
The prompt used for generating the image.

​
Input Example

{
  "prompt": "Put the little duckling on top of the woman's t-shirt.",
  "guidance_scale": 3.5,
  "sync_mode": false,
  "num_images": 1,
  "output_format": "jpeg",
  "safety_tolerance": "2",
  "enhance_prompt": false,
  "image_urls": [
    "https://v3.fal.media/files/penguin/XoW0qavfF-ahg-jX4BMyL_image.webp",
    "https://v3.fal.media/files/tiger/bml6YA7DWJXOigadvxk75_image.webp"
  ]
}

​
Output Example

{
  "images": [
    {
      "url": "",
      "content_type": "image/jpeg"
    }
  ],
  "prompt": ""
}

​
Limitations

  • guidance_scale range: 1 to 20
  • num_images range: 1 to 4
  • output_format restricted to: jpeg, png
  • safety_tolerance restricted to: 1, 2, 3, 4, 5, 6