Flux Dev LoRA

Flux Dev LoRA

Playground

Try it on WavespeedAI!

Super fast endpoint for the FLUX.1 [dev] model with LoRA support, enabling rapid and high-quality image generation using pre-trained LoRA adaptations for personalization, specific styles, brand identities, and product-specific outputs.

Features

Flux-dev-lora

FLUX.1 [dev] is a 12B parameter rectified flow transformer for advanced text-to-image generation. It supports prompt-only generation as well as image inpainting and LoRA customization, making it a flexible tool for both research and creative workflows.


Why it looks great

  • High-quality output: Cutting-edge visual fidelity, second only to FLUX.1 [pro].
  • Prompt alignment: Strong competitive prompt following, rivaling closed-source alternatives.
  • Efficient training: Trained with guidance distillation for better speed-performance balance.
  • Flexible editing: Supports image + mask editing, LoRA fine-tuning, and custom strength control.
  • Open weights: Enables research, experimentation, and innovative creative pipelines.

Limits and Performance

  • Max resolution: up to 1536 × 1536 pixels

  • Optional inputs:

    • image (for img2img)
    • mask_image (for inpainting)
  • LoRA support: add multiple .safetensors with adjustable scale

  • Inference controls:

    • num_inference_steps (default ~28)
    • guidance_scale (default ~3.5)
    • strength (the strength of transform the reference image)
  • Output format: JPEG / PNG / WEBP

  • Seed: reproducibility (-1 = random)


Pricing

Just $0.015 per image !!


How to Use

  1. Write a prompt — detailed scene + style (lighting, realism, mood).

  2. (Optional) Upload an image to guide generation.

  3. (Optional) Add a mask image for inpainting.

  4. Adjust parameters:

    • Strength (the strength of transform the reference image).
    • LoRAs (add path/URL + scale).
    • Size (width & height, up to 1024×1024).
    • Inference steps and guidance scale.
  5. Set num_images (default 1).

  6. (Optional) Fix seed for reproducibility.

  7. Choose output format and run.


Pro tips

  • Use higher inference steps for more detail, lower for speed.
  • Adjust guidance scale to balance prompt strength vs. creativity (3–7 recommended).
  • Apply mask + strength for clean local edits (inpainting).
  • Blend multiple LoRAs for hybrid style outputs.
  • Use consistent seeds when testing parameter changes for controlled comparison.

Notes

  • The image URL must be valid and accessible; otherwise, the job may fail.
  • For mask_image, do not upload the original or unprocessed image directly — ensure the mask is correctly prepared.
  • LoRA files must be uploaded from trusted platforms and set to public access to be usable.
  • Parameters such as num_inference_steps (and others) directly affect runtime: the larger the value, the longer the generation will take.

Reference

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/flux-dev-lora" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "strength": 0.8,
    "loras": [
        {
            "path": "strangerzonehf/Flux-Super-Realism-LoRA",
            "scale": 1
        }
    ],
    "size": "1024*1024",
    "num_inference_steps": 28,
    "guidance_scale": 3.5,
    "num_images": 1,
    "seed": -1,
    "output_format": "jpeg",
    "enable_base64_output": false,
    "enable_sync_mode": false
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"

Parameters

Task Submission Parameters

Request Parameters

ParameterTypeRequiredDefaultRangeDescription
promptstringYes-The positive prompt for the generation.
imagestringNo-
mask_imagestringNo-The mask image tells the model where to generate new pixels (white) and where to preserve the original image (black). It acts as a stencil or guide for targeted image editing.
strengthnumberNo0.80.00 ~ 1.00Strength indicates extent to transform the reference image.
lorasarrayNomax 4 itemsList of LoRAs to apply (max 4).
loras[].pathstringYes-Path to the LoRA model
loras[].scalefloatYes-0.0 ~ 4.0Scale of the LoRA model
sizestringNo1024*1024256 ~ 1536 per dimensionThe size of the generated media in pixels (width*height).
num_inference_stepsintegerNo281 ~ 50The number of inference steps to perform.
guidance_scalenumberNo3.50.0 ~ 20.0The guidance scale to use for the generation.
num_imagesintegerNo11 ~ 4The number of images to generate.
seedintegerNo-1-1 ~ 2147483647The random seed to use for the generation. -1 means a random seed will be used.
output_formatstringNojpegjpeg, png, webpThe format of the output image.
enable_base64_outputbooleanNofalse-If enabled, the output will be encoded into a BASE64 string instead of a URL. This property is only available through the API.
enable_sync_modebooleanNofalse-If set to true, the function will wait for the result to be generated and uploaded before returning the response. It allows you to get the result directly in the response. This property is only available through the API.

Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.has_nsfw_contentsarrayArray of boolean values indicating NSFW detection for each output
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

© 2025 WaveSpeedAI. All rights reserved.