Flux Dev LoRA Ultra Fast
Playground
Try it on WaveSpeedAI!Ultra-fast FLUX.1 [dev] endpoint with LoRA support for high-quality image generation, personalization, and brand/style adaptation. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Features
FLUX Dev LoRA Ultra Fast is a high-speed image generation and editing model that supports applying up to three LoRAs in a single run. It’s built for rapid iteration: generate new images from a prompt, or guide results with an input image (image-to-image) and an optional mask for localized edits. With LoRA stacking, you can quickly dial in style, character identity, or product aesthetics while keeping latency and cost low.
Key capabilities
- Text-to-image generation with fast turnaround
- Image-to-image generation for guided edits and variations
- Masked editing (inpainting-style) for localized changes
- LoRA support: add up to 3 LoRAs per run
- Adjustable strength for how strongly the input image is preserved
- Custom output size, seed control, and standard image formats
Use cases
- Rapid style exploration using one or more LoRAs (photoreal, illustration, anime, etc.)
- Character consistency by stacking identity + style LoRAs
- Product mockups: swap materials/colors and keep composition stable
- Portrait retouching or wardrobe/background changes with a mask
- High-volume generation for ads, thumbnails, and creative testing
Pricing
| Output | Price |
|---|---|
| Per image | $0.006 |
Inputs
- prompt (required): what to generate or how to edit
- image (optional): source image for image-to-image
- mask_image (optional): edit region mask (for localized edits)
- loras (optional): list of LoRA items (up to 3)
Parameters
- strength: how much to follow the input image (higher = more change; lower = more preservation)
- loras[].path: LoRA identifier (owner/model) or a public.safetensors URL
- loras[].scale: LoRA weight (typical range ~0.6–1.2 depending on LoRA)
- width / height: output size
- num_inference_steps: sampling steps
- guidance_scale: prompt adherence strength
- num_images: number of images to generate per run
- seed: random seed (-1 for random; set for reproducible results)
- output_format: jpeg / png / webp, etc.
- enable_base64_output: return BASE64 instead of URL (API only)
Prompting tips
- If you’re stacking LoRAs, keep the base prompt clean and let LoRAs do the heavy lifting.
- For edits, describe the change explicitly and keep “what stays the same” implicit via the input image.
- For text rendering in images, keep on-image text short and specify placement/material.
Example prompts
- Super realism, ultra high-resolution photograph, cinematic lighting, shallow depth of field, shot on a Sony A7III, natural skin texture, sharp eyes, soft bokeh background.
- Edit: change the outfit to a light gray sweater and gold thin-rimmed glasses, keep the same face and hairstyle, realistic studio lighting.
Authentication
For authentication details, please refer to the Authentication Guide.
API Endpoints
Submit Task & Query Result
set -euo pipefail
export WAVESPEED_API_KEY="your-api-key"
REQUEST_BODY=$(cat <<'JSON'
{
"prompt": "A cinematic ocean wave at sunrise, highly detailed",
"strength": 0.8,
"size": "1024*1024",
"num_inference_steps": 28,
"guidance_scale": 3.5,
"num_images": 1,
"seed": -1,
"output_format": "jpeg"
}
JSON
)
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/flux-dev-lora-ultra-fast" \
-H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
-H "Content-Type: application/json" \
-d "${REQUEST_BODY}")
TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL=$(printf '%s' "${TASK}" | jq -r '.urls.get // empty')
if [ -z "${RESULT_URL}" ]; then RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"; fi
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body \
"${RESULT_URL}" \
-H "Authorization: Bearer ${WAVESPEED_API_KEY}")
RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')
case "${STATUS}" in
completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
failed|cancelled|timeout) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
created|processing) sleep 2 ;;
*) printf 'Unexpected status: %s
' "${STATUS}" >&2; exit 1 ;;
esac
doneParameters
Task Submission Parameters
Request Parameters
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| prompt | string | Yes | - | The positive prompt for the generation. | |
| image | string | No | - | - | |
| mask_image | string | No | - | 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. | |
| strength | number | No | 0.8 | 0.01 ~ 1 | Strength indicates extent to transform the reference image. |
| loras | array<object> | No | 0 ~ 3 items | List of LoRAs to apply (max 3). | |
| size | string | No | 1024*1024 | - | The size of the generated media in pixels (width*height). |
| num_inference_steps | integer | No | 28 | 1 ~ 50 | The number of inference steps to perform. |
| guidance_scale | number | No | 3.5 | 0 ~ 20 | The guidance scale to use for the generation. |
| num_images | integer | No | 1 | 1 ~ 4 | The number of images to generate. |
| seed | integer | No | -1 | - | The random seed to use for the generation. -1 means a random seed will be used. |
| output_format | string | No | jpeg | jpeg, png, webp | The format of the output image. |
| enable_base64_output | boolean | No | false | - | If set to `true`, the prediction's `output` strings are returned as **naked base64** (no `data:<mime>;base64,` prefix). When `false` (default), outputs are returned as URLs pointing to our CDN. |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data.id | string | Unique identifier for the prediction, Task Id |
| data.model | string | Model ID used for the prediction |
| data.outputs | array | Output values, usually URL strings; some models return text strings or structured result objects (empty when status is not completed) |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to retrieve the prediction result |
| data.status | string | Status of the task: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”) |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |
Result Request Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| id | string | Yes | - | Task ID |
Result Response Parameters
| Parameter | Type | Description |
|---|---|---|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., “success”) |
| data | object | The prediction data object containing all details |
| data.id | string | Unique identifier for the prediction |
| data.model | string | Model ID used for the prediction |
| data.outputs | array<string | object> | Array of generated outputs (empty when status is not completed). Items are usually URL strings, but may be text strings or structured result objects, depending on the model. |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to poll for the prediction result |
| data.status | string | Status: created, processing, completed, or failed |
| data.created_at | string | ISO timestamp of when the request was created |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |