FLUX 2 Lora Edit

edit

fal-ai/flux-2/lora/edit

Run FLUX.2 edit LoRAs on up to three input images.

Image editing on FLUX.2 [dev] with LoRA support: pass one to three input images and a prompt, and a trained edit LoRA applies the transformation it learned from its start and end pairs. Pairs directly with flux-2-trainer/edit.

Open in fal playground ↗Official API docs ↗

Parameters

Schema facts from the fal API; the notes are ours.

Required

promptstringrequired

The text description of what to generate.

Tip: If your LoRA used a trigger word, include it. Describe the scene around the subject normally.

Raw schema description

The prompt to generate an image from.

image_urlslistrequired

Input images for editing. The edit LoRA decides how they are transformed.

Raw schema description

The URsL of the images for editing. A maximum of 3 images are allowed, if more are provided, only the first 3 will be used.

Optional

guidance_scalenumberdefault: 2.50 – 20

How strictly generation follows the prompt (classifier-free guidance).

In the atelier: How tightly you hold the painter to the brief. Too tight and the work gets stiff and oversaturated; too loose and he wanders.

Tip: Stay near the endpoint default. Adjust in steps of 0.5.

Raw schema description

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.

seedinteger

Random seed. Same seed plus same inputs gives a nearly identical image.

Tip: Fix the seed when comparing LoRA scales or parameters, so the only thing changing is the thing you are testing.

Raw schema description

The seed to use for the generation. If not provided, a random seed will be used.

num_inference_stepsintegerdefault: 284 – 50

Number of denoising steps per image. More steps, more refinement, more latency.

Tip: Defaults are tuned per model. Cutting steps in half is the quickest way to trade quality for speed.

Raw schema description

The number of inference steps to perform.

image_sizeobject

Output resolution, as a preset name or explicit width and height.

Raw schema description

The size of the image to generate. The width and height must be between 512 and 2048 pixels.

num_imagesintegerdefault: 11 – 4

How many images to generate in one call.

Raw schema description

The number of images to generate.

accelerationenumdefault: regularnone | regular | high

Speed and cost preset for the generation backend.

Tip: 'regular' balances quality and latency. Use higher acceleration for drafts and iteration.

Raw schema description

The acceleration level to use for the image generation.

enable_prompt_expansionbooleandefault: false

Lets the endpoint rewrite your prompt with more detail before generating.

Raw schema description

If set to true, the prompt will be expanded for better results.

sync_modebooleandefault: false

Returns media as a data URI instead of a hosted URL, and skips storing it.

Tip: Useful for privacy; awkward for big files. Most workflows leave it off.

Raw schema description

If `True`, the media will be returned as a data URI and the output data won't be available in the request history.

enable_safety_checkerbooleandefault: true

Runs a safety filter on outputs.

Raw schema description

If set to true, the safety checker will be enabled.

output_formatenumdefault: pngjpeg | png | webp

File format of the result: jpeg, png or webp.

Raw schema description

The format of the generated image.

loraslistdefault: []

List of LoRA weights to load, each with a path (URL or HF repo) and a scale.

In the atelier: Which bracelets the painter wears for this painting, and how hard he leans on each.

Tip: Order does not matter; scales do. Start every LoRA at 1.0 and adjust one at a time.

Watch out: Stacking three strong LoRAs usually degrades all of them. Lower each scale when combining.

Raw schema description

List of LoRA weights to apply (maximum 3). Each LoRA can be a URL, HuggingFace repo ID, or local path.

Call it

import { fal } from "@fal-ai/client";

const result = await fal.subscribe("fal-ai/flux-2/lora/edit", {
  input: {
    "prompt": "turn the sketch into a finished painting",
    "image_urls": [
      "https://your-cdn.com/input.jpg"
    ],
    "loras": [
      {
        "path": "https://your-cdn.com/lora.safetensors",
        "scale": 1
      }
    ]
  },
  logs: true,
});
console.log(result.data);

Train the LoRA with

FLUX 2 Trainer Edit

fal-ai/flux-2-trainer/edit