Flux Kontext Dev Lora
FLUX.1 Kontext LoRA [dev] is a development version of the state-of-the-art image editing model that lets you edit images using text prompts and LoRA models. It makes editing intuitive by understanding the relationship between visuals and language, with support for custom styles through LoRA models.
Features
FLUX.1 Kontext LoRA [dev] is a development version of the state-of-the-art image editing model by Black Forest Labs that lets you edit images using text prompts and LoRA models. It makes editing intuitive by understanding the relationship between visuals and language. You can make precise changes to objects, scenes, and layout — all without disrupting the composition.
Key Features
- LoRA Support: Apply custom styles and transformations using LoRA models for personalized results.
- Context-Aware Editing: Intelligent understanding of image semantics for precise modifications that preserve natural aesthetics.
- Precision Control: Granular control over transformations with intuitive parameters and fine-tuning capabilities.
- SOTA Quality: State-of-the-art results surpassing existing models across all quality benchmarks.
Use Cases
- Style Transfer: Convert photos to different art styles using LoRA models.
- Object/Clothing Changes: Modify hairstyles, add accessories, change colors with style-specific LoRAs.
- Text Editing: Replace text in signs, posters, and labels.
- Background Swapping: Change environments while preserving subjects.
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-kontext-dev-lora" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
"prompt": "Transform the image into detailed anime style. Keep the original composition and layout, but render all characters with smooth outlines, large expressive eyes, vibrant hair colors, and soft cel-shading. Background should resemble high-quality anime scenes — painterly skies, stylized lighting, and subtle gradients. Make it feel like a frame from a cinematic anime.",
"image": "https://d2g64w682n9w0w.cloudfront.net/media/images/1750946079467288286_Un9mK4mu.jpg",
"size": "1024*1024",
"num_inference_steps": 28,
"guidance_scale": 2.5,
"num_images": 1,
"seed": -1,
"loras": [],
"enable_base64_output": false,
"enable_safety_checker": true
}'
# 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
Parameter | Type | Required | Default | Range | Description |
---|---|---|---|---|---|
prompt | string | Yes | Transform the image into detailed anime style. Keep the original composition and layout, but render all characters with smooth outlines, large expressive eyes, vibrant hair colors, and soft cel-shading. Background should resemble high-quality anime scenes — painterly skies, stylized lighting, and subtle gradients. Make it feel like a frame from a cinematic anime. | - | The prompt to generate an image from. |
image | string | No | https://d2g64w682n9w0w.cloudfront.net/media/images/1750946079467288286_Un9mK4mu.jpg | - | The image to generate an image from. |
size | string | No | 1024*1024 | 512 ~ 1536 per dimension | The size of the generated image. |
num_inference_steps | integer | No | 28 | 1 ~ 50 | The number of inference steps to perform. |
guidance_scale | number | No | 2.5 | 0.0 ~ 20.0 | The CFG (Classifier Free 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. |
num_images | integer | No | 1 | 1 ~ 4 | The number of images to generate. |
seed | integer | No | -1 | -1 ~ 9999999999 | The same seed and the same prompt given to the same version of the model will output the same image every time. |
loras | array | No | [] | max 5 items | List of LoRAs to apply (max 5) |
loras[].path | string | Yes | - | Path to the LoRA model | |
loras[].scale | float | Yes | - | 0.0 ~ 4.0 | Scale of the LoRA model |
enable_base64_output | boolean | No | false | - | If enabled, the output will be encoded into a BASE64 string instead of a URL. |
enable_safety_checker | boolean | No | true | - | If set to true, the safety checker will be enabled. |
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 | Array of URLs to the generated content (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.has_nsfw_contents | array | Array of boolean values indicating NSFW detection for each output |
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 Query Parameters
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 | Array of URLs to the generated content (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.has_nsfw_contents | array | Array of boolean values indicating NSFW detection for each output |
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 |