FLUX 2 Lora
generalfal-ai/flux-2/lora
Text-to-image on flagship FLUX.2 [dev] with up to three LoRAs.
The inference home for flux-2-trainer output. Up to three LoRAs load at once, each a URL, Hugging Face repo or path with a scale. Compared to Klein it is slower and pricier per image, with the fidelity to match.
Parameters
Schema facts from the fal API; the notes are ours.
Required
promptstringrequiredThe 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.
Optional
guidance_scalenumberdefault: 2.50 – 20How 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.
seedintegerRandom 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 – 50Number 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_sizeobjectdefault: landscape_4_3Output 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 – 4How many images to generate in one call.
Raw schema description
The number of images to generate.
accelerationenumdefault: regularnone | regular | highSpeed 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: falseLets 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: falseReturns 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: trueRuns a safety filter on outputs.
Raw schema description
If set to true, the safety checker will be enabled.
output_formatenumdefault: pngjpeg | png | webpFile 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", {
input: {
"prompt": "a photo of TOK on a sunny windowsill",
"loras": [
{
"path": "https://your-cdn.com/lora.safetensors",
"scale": 1
}
]
},
logs: true,
});
console.log(result.data);