Skip to main content

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

FieldValue
API-KEY<api-key>
Content-Typeapplication/json

Parameters

ParameterTypeRequiredDescription
typestringYesMust be IMAGE_GENERATOR
modelstringYesMust be black-forest-labs/flux-2-dev
promptObjectobjectYesConfiguration object containing all generation parameters

Prompt Object Parameters

ParameterTypeRequiredDescriptionDefault
promptstringYesText description of the image to generate-
aspect_ratiostringNoImage aspect ratio (1:1, 16:9, 9:16, 3:2, 2:3, 4:5, 5:4)1:1
output_formatstringNoOutput file format (webp, jpg, png)webp
output_qualitynumberNoOutput image quality (0-100)80
num_inference_stepsnumberNoNumber of denoising steps (1-50)28
guidancenumberNoPrompt adherence scale (0-10)3
prompt_strengthnumberNoHow much to transform a reference image (0-1); 1 = full replacement0.8
go_fastbooleanNoEnable speed-optimized generationfalse
megapixelsstringNoOutput resolution in megapixels (0.25, 1)1
disable_safety_checkerbooleanNoDisable built-in safety filteringfalse
seednumberNoRandom seed for reproducibilityRandom

Code Examples

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
}
}'

Interactive Playground

API Playground

https://api.1min.ai/api/features
Describe 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