Flux Kontext Dev Multi
FLUX.1 Kontext Multi [dev] is a development version of the state-of-the-art image editing model that lets you edit multiple images using text prompts. It makes batch editing intuitive by understanding the relationship between visuals and language.
Features
FLUX.1 Kontext Multi [dev] is a development version of the state-of-the-art image editing model by Black Forest Labs that lets you edit multiple images using text prompts. It makes batch editing intuitive by understanding the relationship between visuals and language. You can make precise changes to multiple images at once — all while maintaining consistency across the batch.
Key Features
- Batch Processing: Edit multiple images simultaneously with consistent results.
- Context-Aware Editing: Intelligent understanding of image semantics for precise modifications that preserve natural aesthetics.
- Lightning Fast: Optimized neural architecture delivers professional results in seconds for real-time workflows.
- 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 multiple photos to different art styles, like watercolor, oil painting and sketches.
- Object/Clothing Changes: Modify hairstyles, add accessories, change colors across multiple images.
- Text Editing: Replace text in signs, posters, and labels in bulk.
- Background Swapping: Change environments while preserving subjects across multiple images.
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/multi" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
"prompt": "A man standing by the ocean, wearing a crisp white shirt with sleeves casually rolled up. He’s holding a fresh coconut in one hand and gazing toward the horizon. The beach is sunlit and peaceful, with soft waves, golden sand, and a gentle breeze ruffling his shirt. Relaxed and summery mood.",
"images": [
"https://d2g64w682n9w0w.cloudfront.net/media/images/1750946221123208007_M1YURNLH.png",
"https://d2g64w682n9w0w.cloudfront.net/media/images/1750946250550516343_7mSOLHEA.webp",
"https://d2g64w682n9w0w.cloudfront.net/media/images/1750946240650738815_zAOLGDzv.jpg"
],
"size": "1024*1024",
"num_inference_steps": 28,
"guidance_scale": 2.5,
"num_images": 1,
"seed": -1,
"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 | A man standing by the ocean, wearing a crisp white shirt with sleeves casually rolled up. He’s holding a fresh coconut in one hand and gazing toward the horizon. The beach is sunlit and peaceful, with soft waves, golden sand, and a gentle breeze ruffling his shirt. Relaxed and summery mood. | - | The prompt to generate an image from. |
images | array | No | https://d2g64w682n9w0w.cloudfront.net/media/images/1750946221123208007_M1YURNLH.pnghttps://d2g64w682n9w0w.cloudfront.net/media/images/1750946250550516343_7mSOLHEA.webphttps://d2g64w682n9w0w.cloudfront.net/media/images/1750946240650738815_zAOLGDzv.jpg | - | URL of images to use while generating the image. |
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 | 1.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. |
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 |