Flux Pro Kontext Max API

Max
Multi
Text To Image

Endpoint: POST https://fal.run/fal-ai/flux-pro/kontext/max Endpoint ID: fal-ai/flux-pro/kontext/max

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/max",
    arguments={
        "prompt": "Put a donut next to the flour.",
        "image_url": "https://v3.fal.media/files/rabbit/rmgBxhwGYb2d3pl3x9sKf_output.png"
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

Examples

Restyle to Claymation style

Generated image: Restyle to Claymation style

Change the car color to green

Generated image: Change the car color to green

replace ‘joy’ by ‘fal”

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_url

string

required

Image prompt for the omni model.

Output Schema

images

list<fal__toolkit__image__image__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 a donut next to the flour.",
  "guidance_scale": 3.5,
  "sync_mode": false,
  "num_images": 1,
  "output_format": "jpeg",
  "safety_tolerance": "2",
  "enhance_prompt": false,
  "image_url": "https://v3.fal.media/files/rabbit/rmgBxhwGYb2d3pl3x9sKf_output.png"
}

Output Example

{
  "images": [
    {
      "height": 1024,
      "url": "https://fal.media/files/tiger/7dSJbIU_Ni-0Zp9eaLsvR_fe56916811d84ac69c6ffc0d32dca151.jpg",
      "width": 1024
    }
  ],
  "prompt": ""
}

Endpoint: POST https://fal.run/fal-ai/flux-pro/kontext/max/multi Endpoint ID: fal-ai/flux-pro/kontext/max/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/max/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)

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": ""
}

Endpoint: POST https://fal.run/fal-ai/flux-pro/kontext/max/text-to-image Endpoint ID: fal-ai/flux-pro/kontext/max/text-to-image

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/max/text-to-image",
    arguments={
        "prompt": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture."
    },
    with_logs=True,
    on_queue_update=on_queue_update,
)
print(result)

Examples

A solo figure sits on a wooden stool in a dimly lit virtual reality dive bar with textured concrete walls and neon art by Nick Knight.

Generated image: A solo figure sits on a wooden stool in a dimly lit virtual reality dive bar wit

In the mystical realm of Aethereia, where moonlit rivers flowed with stardust and crystal forests pierced the sky, a serene marble bath tub sat at the river’s edge, surrounded by luxury decor that shimmered with an ethereal glow, as if infused with the soft, sensual light of sun rays dancing through…

Generated image: In the mystical realm of Aethereia, where moonlit rivers flowed with stardust an

A woman stands centered in a secret underground city, surrounded by blurred foliage and a creek, under an overcast sky with natural light.

Generated image: A woman stands centered in a secret underground city, surrounded by blurred foli

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

AspectRatioEnum

default:"1:1"

The aspect ratio of the generated image. Default value: "1:1"Possible values: 21:9, 16:9, 4:3, 3:2, 1:1, 2:3, 3:4, 9:16, 9:21

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": "Extreme close-up of a single tiger eye, direct frontal view. Detailed iris and pupil. Sharp focus on eye texture and color. Natural lighting to capture authentic eye shine and depth. The word \"FLUX\" is painted over it in big, white brush strokes with visible texture.",
  "guidance_scale": 3.5,
  "sync_mode": false,
  "num_images": 1,
  "output_format": "jpeg",
  "safety_tolerance": "2",
  "enhance_prompt": false,
  "aspect_ratio": "1:1"
}

Output Example

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

FLUX.1 Kontext [pro] — Image Generation

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

Video Generation

Image Generation

Audio

Vision

3D

Flux Pro Kontext Max API

Try it in the Playground

Quick Start

Examples

Input Schema

Output Schema

Input Example

Output Example

Try it in the Playground

Quick Start

Input Schema

Output Schema

Input Example

Output Example

Try it in the Playground

Quick Start

Examples

Input Schema

Output Schema

Input Example

Output Example

Limitations

Video Generation

Image Generation

Audio

Vision

3D

Try it in the Playground

​Quick Start

​Examples

​Input Schema

​Output Schema

​Input Example

​Output Example

Try it in the Playground

​Quick Start

​Input Schema

​Output Schema

​Input Example

​Output Example

Try it in the Playground

​Quick Start

​Examples

​Input Schema

​Output Schema

​Input Example

​Output Example

​Related

​Limitations

Quick Start

Examples

Input Schema

Output Schema

Input Example

Output Example

Quick Start

Input Schema

Output Schema

Input Example

Output Example

Quick Start

Examples

Input Schema

Output Schema

Input Example

Output Example

Related

Limitations