Flux Kontext Dev
FLUX.1 Kontext [dev] is a development version of the state-of-the-art image editing model that lets you edit images using text prompts. It makes editing intuitive by understanding the relationship between visuals and language.
Features
FLUX.1 Kontext [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. 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
- 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 photos to different art styles, like watercolor, oil painting and sketches.
- Object/Clothing Changes: Modify hairstyles, add accessories, change colors.
- 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" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
"prompt": "Change the car color to red.",
"image": "https://d2g64w682n9w0w.cloudfront.net/media/images/1750940187685254815_W4yPaBQU.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 | Change the car color to red. | - | The prompt to generate an image from. |
| image | string | No | https://d2g64w682n9w0w.cloudfront.net/media/images/1750940187685254815_W4yPaBQU.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 | 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 |