Flux Dev
Playground
Try it on WavespeedAI!FLUX.1 [dev] is a 12-billion-parameter rectified-flow transformer for text-to-image generation. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Features
FLUX.1 [dev]
Generate high-quality images with FLUX.1 [dev], a versatile and powerful image generation model. Whether you need text-to-image creation, image-to-image transformation, or precise inpainting — this model delivers stunning results with exceptional detail and prompt adherence.
Why It Stands Out
- Multi-mode generation: Supports text-to-image, image-to-image, and inpainting workflows in one model.
- High resolution output: Generate images up to 1024×1024 with sharp detail and clarity.
- Prompt Enhancer: Built-in AI-powered prompt optimization for better results.
- Flexible aspect ratios: Customize width and height independently for any format.
- Batch generation: Create multiple images in a single request.
- Reproducibility: Use the seed parameter to recreate exact results or explore variations.
- Multiple output formats: Export as JPEG or PNG based on your needs.
Pricing
| Output | Price |
|---|---|
| Per image | $0.012 |
Total cost = $0.012 × num_images
Parameters
| Parameter | Required | Description |
|---|---|---|
| prompt | Yes | Text description of the image you want to generate. |
| image | No | Source image for image-to-image or inpainting mode. |
| mask_image | No | Mask image for inpainting (white areas will be regenerated). |
| strength | No | How much to transform the source image (0.0–1.0, default: 0.8). |
| width | No | Output width in pixels (default: 1024). |
| height | No | Output height in pixels (default: 1024). |
| num_inference_steps | No | Quality/speed trade-off (default: 28). |
| seed | No | Set for reproducibility; -1 for random. |
| guidance_scale | No | Prompt adherence strength (default: 3.5). |
| num_images | No | Number of images to generate (default: 1). |
| output_format | No | Output format: jpeg or png (default: jpeg). |
| enable_base64_output | No | Return base64 string instead of URL (API only). |
| enable_sync_mode | No | Wait for result before returning response (API only). |
How to Use
Text-to-Image:
- Write a prompt describing the image you want. Use the Prompt Enhancer for AI-assisted optimization.
- Set width and height for your desired aspect ratio.
- Adjust guidance_scale and num_inference_steps as needed.
- Click Run and download your image.
Image-to-Image:
- Upload a source image.
- Write a prompt describing the transformation you want.
- Adjust the strength parameter — higher values allow more dramatic changes.
- Click Run and download your image.
Inpainting:
- Upload a source image and a mask image.
- White areas in the mask will be regenerated based on your prompt.
- Write a prompt describing what should appear in the masked region.
- Click Run and download your image.
Best Use Cases
- Creative Art & Illustration — Generate unique artwork, concept art, and digital illustrations.
- Product Visualization — Create product mockups and lifestyle imagery.
- Marketing & Social Media — Produce eye-catching visuals for campaigns and posts.
- Photo Editing & Enhancement — Transform or repair images with inpainting.
- Design Prototyping — Quickly visualize ideas before committing to full production.
Pro Tips for Best Quality
- Be descriptive in your prompt — include style, mood, lighting, composition, and specific details.
- For image-to-image, use lower strength (0.3–0.5) to preserve more of the original, higher (0.7–0.9) for dramatic changes.
- Use inpainting with precise masks for seamless object removal or replacement.
- Fix the seed when iterating to compare the effect of different parameters.
- Generate multiple images (num_images > 1) to explore variations quickly.
Notes
- If using image URLs, ensure they are publicly accessible.
- Processing time varies based on resolution and current queue load.
- Please ensure your prompts comply with content guidelines.
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" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
"strength": 0.8,
"size": "1024*1024",
"num_inference_steps": 28,
"seed": -1,
"guidance_scale": 3.5,
"num_images": 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
| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
| prompt | string | Yes | - | The positive prompt for the generation. | |
| image | string | No | - | The image to generate an image from. | |
| 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.00 ~ 1.00 | Strength indicates extent to transform the reference image. |
| size | string | No | 1024*1024 | 256 ~ 1536 per dimension | 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. |
| seed | integer | No | -1 | -1 ~ 2147483647 | The random seed to use for the generation. -1 means a random seed will be used. |
| guidance_scale | number | No | 3.5 | 1.0 ~ 20.0 | The guidance scale to use for the generation. |
| num_images | integer | No | 1 | 1 ~ 4 | The number of images to generate. |
| output_format | string | No | jpeg | jpeg, png, webp | The format of the output image. |
| enable_base64_output | boolean | No | false | - | 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_mode | boolean | No | false | - | 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
| 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 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, the ID of the prediction to get |
| data.model | string | Model ID used for the prediction |
| data.outputs | string | 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.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 |