Flux 2 Dev - Image Generator
Open-weight 32 billion parameter image generation model by Black Forest Labs. Combines high-quality text-to-image generation with multi-reference support and flexible customization, available for academic and commercial use.
Also supports Image Editing
This model also supports IMAGE_EDITOR mode for text-based image editing. See Flux 2 Dev - Image Editor.
Endpoint
Request Headers
| Field | Value |
|---|---|
| API-KEY | <api-key> |
| Content-Type | application/json |
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
type | string | Yes | Must be IMAGE_GENERATOR |
model | string | Yes | Must be black-forest-labs/flux-2-dev |
promptObject | object | Yes | Configuration object containing all generation parameters |
Prompt Object Parameters
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
prompt | string | Yes | Text description of the image to generate | - |
aspect_ratio | string | No | Image aspect ratio (1:1, 16:9, 9:16, 3:2, 2:3, 4:5, 5:4) | 1:1 |
output_format | string | No | Output file format (webp, jpg, png) | webp |
output_quality | number | No | Output image quality (0-100) | 80 |
num_inference_steps | number | No | Number of denoising steps (1-50) | 28 |
guidance | number | No | Prompt adherence scale (0-10) | 3 |
prompt_strength | number | No | How much to transform a reference image (0-1); 1 = full replacement | 0.8 |
go_fast | boolean | No | Enable speed-optimized generation | false |
megapixels | string | No | Output resolution in megapixels (0.25, 1) | 1 |
disable_safety_checker | boolean | No | Disable built-in safety filtering | false |
seed | number | No | Random seed for reproducibility | Random |
Code Examples
- cURL
- JavaScript
- Python
curl --location 'https://api.1min.ai/api/features' \
--header 'API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"type": "IMAGE_GENERATOR",
"model": "black-forest-labs/flux-2-dev",
"promptObject": {
"prompt": "A cozy coffee shop interior in the morning, warm light, steam rising from a cup",
"aspect_ratio": "4:5",
"num_inference_steps": 28,
"guidance": 3.5,
"megapixels": "1",
"output_format": "webp",
"output_quality": 85
}
}'
fetch('https://api.1min.ai/api/features', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'API-KEY': 'YOUR_API_KEY'
},
body: JSON.stringify({
type: 'IMAGE_GENERATOR',
model: 'black-forest-labs/flux-2-dev',
promptObject: {
prompt: 'A cozy coffee shop interior in the morning, warm light, steam rising from a cup',
aspect_ratio: '4:5',
num_inference_steps: 28,
guidance: 3.5,
megapixels: '1',
output_format: 'webp',
output_quality: 85
}
})
})
import requests
url = "https://api.1min.ai/api/features"
headers = {
"Content-Type": "application/json",
"API-KEY": "YOUR_API_KEY"
}
data = {
"type": "IMAGE_GENERATOR",
"model": "black-forest-labs/flux-2-dev",
"promptObject": {
"prompt": "A cozy coffee shop interior in the morning, warm light, steam rising from a cup",
"aspect_ratio": "4:5",
"num_inference_steps": 28,
"guidance": 3.5,
"megapixels": "1",
"output_format": "webp",
"output_quality": 85
}
}
response = requests.post(url, headers=headers, json=data)
Interactive Playground
API Playground
https://api.1min.ai/api/featuresDescribe the image you want to generate
Number of denoising steps (1-50)
Prompt adherence scale (0-10)
Output image quality (0-100)
Random seed for reproducibility
Generated cURL Command:
curl -X POST "https://api.1min.ai/api/features" \
-H "API-KEY: <your-api-key>" \
-H "Content-Type: application/json" \
-d '{
"type": "IMAGE_GENERATOR",
"model": "black-forest-labs/flux-2-dev",
"promptObject": {
"prompt": "A cozy coffee shop interior in the morning, warm light, steam rising from a cup",
"aspect_ratio": "4:5",
"num_inference_steps": 28,
"guidance": 3.5,
"megapixels": "1",
"output_format": "webp",
"output_quality": 85
}
}'
Response Format
{
"aiRecord": {
"uuid": "d4e5f6a7-b8c9-0123-defa-234567890123",
"model": "black-forest-labs/flux-2-dev",
"type": "IMAGE_GENERATOR",
"status": "SUCCESS",
"createdAt": "2026-03-27T10:00:00.000Z",
"aiRecordDetail": {
"promptObject": {
"prompt": "A cozy coffee shop interior in the morning, warm light, steam rising from a cup",
"aspect_ratio": "4:5",
"num_inference_steps": 28,
"guidance": 3.5,
"megapixels": "1",
"output_format": "webp",
"output_quality": 85
},
"resultObject": [
"development/images/2026_03_27_10_00_04_001_coffee_shop.webp"
]
},
"temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2026_03_27_10_00_04_001_coffee_shop.webp?..."
}
}
Use Cases
- Research & Development: Open-weight model for custom integrations
- Content Creation: Social media, editorial, and marketing imagery
- Custom Pipelines: Integrate into your own generation workflows
- Rapid Iteration: Flexible step count for speed vs quality trade-offs