# FLUX.3 Klein Image Editing image to image

Edit one product or campaign image at a fixed output size. Needs prompt and image urls. Served by fal.ai.

Edit one product or campaign image at a fixed output size. One output, exactly 1024x1024 pixels; prompt expansion is disabled. Asynchronous: poll fal/status and read fal/result with model "blackforestlabs/flux-3" and the returned request_id.

- Tool ID: `fal/blackforestlabs-flux-3-klein-edit-image`
- Name in the catalog: FLUX.3 Klein Image Editing, image to image
- Provider: [fal.ai](/providers/fal.md)
- Capability: [AI image generation](/tools/image-generation.md)
- Price: $0.009 per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


```json
{
  "model": "per_call",
  "amountUsd": 0.009
}
```

Pricing source: [https://fal.ai/models/blackforestlabs/flux-3/klein/edit-image/llms.txt](https://fal.ai/models/blackforestlabs/flux-3/klein/edit-image/llms.txt). $0.009 per bounded request. One output, exactly 1024x1024 pixels; prompt expansion is disabled. The exact endpoint/request billing receipt supplies the final charge..

Price verification date: 2026-11-03.

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "enable_prompt_expansion": {
      "type": "boolean",
      "description": "If set to true, the prompt is expanded into a detailed caption (grounded in the reference images when editing) before generation.",
      "title": "Enable Prompt Expansion",
      "default": false,
      "enum": [
        false
      ]
    },
    "output_format": {
      "enum": [
        "jpeg",
        "png",
        "webp"
      ],
      "type": "string",
      "description": "The format of the generated image.",
      "title": "Output Format",
      "default": "png"
    },
    "seed": {
      "description": "The same seed and the same prompt given to the same version of the model will output the same image every time.",
      "title": "Seed",
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ]
    },
    "prompt": {
      "type": "string",
      "description": "A complete caption of the target image with the edit folded in. Refer to the references by their order: the first image, the second image.",
      "title": "Prompt"
    },
    "enable_safety_checker": {
      "type": "boolean",
      "description": "If set to true, the safety checker will be enabled.",
      "title": "Enable Safety Checker",
      "default": true,
      "enum": [
        true
      ]
    },
    "bounding_boxes": {
      "description": "Optional layout, with (0, 0) at the top-left of each image: keep, move, resize or remove objects from the references, or place new ones. Name boxes in the prompt by label, e.g. `<dragon>`.",
      "title": "Bounding Boxes",
      "anyOf": [
        {
          "items": {
            "x-fal-order-properties": [
              "label",
              "description",
              "box",
              "source_image_index",
              "source_box",
              "target_box"
            ],
            "type": "object",
            "required": [
              "description"
            ],
            "title": "EditBoundingBox",
            "properties": {
              "label": {
                "description": "Short name for the object in this box, e.g. `dragon`. Write `<dragon>` in the prompt to tie the box to those words; a box the prompt doesn't name is added to the scene. Defaults to `obj_<n>`.",
                "title": "Label",
                "anyOf": [
                  {
                    "pattern": "^[A-Za-z][A-Za-z0-9_]*$",
                    "type": "string",
                    "maxLength": 64
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "target_box": {
                "description": "Where the object goes in the output image. Leave unset to remove a referenced object; set both boxes to move or resize it.",
                "anyOf": [
                  {
                    "x-fal-order-properties": [
                      "x_min",
                      "y_min",
                      "x_max",
                      "y_max"
                    ],
                    "type": "object",
                    "required": [
                      "x_min",
                      "y_min",
                      "x_max",
                      "y_max"
                    ],
                    "title": "Box",
                    "properties": {
                      "y_min": {
                        "maximum": 1,
                        "type": "number",
                        "description": "Top edge as a fraction of the image height (0-1).",
                        "title": "Y Min",
                        "minimum": 0
                      },
                      "x_min": {
                        "maximum": 1,
                        "type": "number",
                        "description": "Left edge as a fraction of the image width (0-1).",
                        "title": "X Min",
                        "minimum": 0
                      },
                      "x_max": {
                        "maximum": 1,
                        "type": "number",
                        "description": "Right edge as a fraction of the image width (0-1).",
                        "title": "X Max",
                        "minimum": 0
                      },
                      "y_max": {
                        "maximum": 1,
                        "type": "number",
                        "description": "Bottom edge as a fraction of the image height (0-1).",
                        "title": "Y Max",
                        "minimum": 0
                      }
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "description": {
                "type": "string",
                "description": "What to draw in this box: the object and its look.",
                "title": "Description",
                "maxLength": 500
              },
              "box": {
                "description": "Where the object goes in the output image, as on text-to-image. Use instead of `source_box`/`target_box`.",
                "anyOf": [
                  {
                    "x-fal-order-properties": [
                      "x_min",
                      "y_min",
                      "x_max",
                      "y_max"
                    ],
                    "type": "object",
                    "required": [
                      "x_min",
                      "y_min",
                      "x_max",
                      "y_max"
                    ],
                    "title": "Box",
                    "properties": {
                      "y_min": {
                        "maximum": 1,
                        "type": "number",
                        "description": "Top edge as a fraction of the image height (0-1).",
                        "title": "Y Min",
                        "minimum": 0
                      },
                      "x_min": {
                        "maximum": 1,
                        "type": "number",
                        "description": "Left edge as a fraction of the image width (0-1).",
                        "title": "X Min",
                        "minimum": 0
                      },
                      "x_max": {
                        "maximum": 1,
                        "type": "number",
                        "description": "Right edge as a fraction of the image width (0-1).",
                        "title": "X Max",
                        "minimum": 0
                      },
                      "y_max": {
                        "maximum": 1,
                        "type": "number",
                        "description": "Bottom edge as a fraction of the image height (0-1).",
                        "title": "Y Max",
                        "minimum": 0
                      }
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "source_image_index": {
                "description": "0-based index into `image_urls` of the reference the object comes from. Leave unset for a new object.",
                "title": "Source Image Index",
                "anyOf": [
                  {
                    "type": "integer",
                    "minimum": 0
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "source_box": {
                "description": "Where the object is in the reference image. Requires `source_image_index`.",
                "anyOf": [
                  {
                    "x-fal-order-properties": [
                      "x_min",
                      "y_min",
                      "x_max",
                      "y_max"
                    ],
                    "type": "object",
                    "required": [
                      "x_min",
                      "y_min",
                      "x_max",
                      "y_max"
                    ],
                    "title": "Box",
                    "properties": {
                      "y_min": {
                        "maximum": 1,
                        "type": "number",
                        "description": "Top edge as a fraction of the image height (0-1).",
                        "title": "Y Min",
                        "minimum": 0
                      },
                      "x_min": {
                        "maximum": 1,
                        "type": "number",
                        "description": "Left edge as a fraction of the image width (0-1).",
                        "title": "X Min",
                        "minimum": 0
                      },
                      "x_max": {
                        "maximum": 1,
                        "type": "number",
                        "description": "Right edge as a fraction of the image width (0-1).",
                        "title": "X Max",
                        "minimum": 0
                      },
                      "y_max": {
                        "maximum": 1,
                        "type": "number",
                        "description": "Bottom edge as a fraction of the image height (0-1).",
                        "title": "Y Max",
                        "minimum": 0
                      }
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            }
          },
          "type": "array",
          "maxItems": 32
        },
        {
          "type": "null"
        }
      ]
    },
    "image_urls": {
      "items": {
        "type": "string"
      },
      "type": "array",
      "description": "The reference images to edit or compose from (up to 10).",
      "title": "Image URLs",
      "minItems": 1,
      "maxItems": 1
    },
    "image_size": {
      "type": "object",
      "properties": {
        "width": {
          "type": "integer",
          "enum": [
            1024
          ]
        },
        "height": {
          "type": "integer",
          "enum": [
            1024
          ]
        }
      },
      "required": [
        "width",
        "height"
      ],
      "additionalProperties": false,
      "default": {
        "width": 1024,
        "height": 1024
      }
    },
    "num_images": {
      "maximum": 1,
      "type": "integer",
      "description": "The number of images to generate.",
      "title": "Number of Images",
      "minimum": 1,
      "default": 1,
      "enum": [
        1
      ]
    }
  },
  "required": [
    "prompt",
    "image_urls"
  ],
  "additionalProperties": false
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "fal/blackforestlabs-flux-3-klein-edit-image",
  "input": {
    "prompt": "A miniature grey amigurumi knight figure crocheted from thick woolen yarn stands on a cliff of stacked yarn skeins at night, lit by a full moon, next to a large fluffy knitted dragon in terracotta and mustard yarn, with a soft out-of-focus backdrop of indigo knitted yarn.",
    "image_urls": [
      "https://storage.googleapis.com/falserverless/example_inputs/z-image-turbo-i2i-input.png"
    ],
    "image_size": {
      "width": 1024,
      "height": 1024
    },
    "num_images": 1,
    "enable_safety_checker": true,
    "enable_prompt_expansion": false,
    "output_format": "png"
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

This tool uses deferred settlement. Follow its returned task/run instructions; preserve the existing reservation until the result is reconciled.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://fal.ai/models/blackforestlabs/flux-3/klein/edit-image)

[REST inspection](https://api.agentik.cc/v1/tools/fal/blackforestlabs-flux-3-klein-edit-image) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/fal/blackforestlabs-flux-3-klein-edit-image) · [Agent index](/llms.txt)
