Flux 2 Flex - Image Generator
Maximum-quality image generation model by Black Forest Labs with adjustable quality-speed trade-offs and support for up to 10 reference images. Excels at typography, design work, and multi-reference blending.
Also supports Image Editing
This model also supports IMAGE_EDITOR mode for text-based image editing. See Flux 2 Flex - 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-flex |
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 (jpg, png) | png |
output_quality | number | No | Output image quality (0-100) | 80 |
steps | number | No | Number of diffusion steps; fewer (6-10) for speed, more (20-50) for quality | 25 |
guidance | number | No | Prompt adherence scale (2-5) | 3 |
safety_tolerance | number | No | Content safety threshold (1=strictest, 6=most permissive) | 2 |
prompt_upsampling | boolean | No | Automatically enhance prompt for more creative output | 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-flex",
"promptObject": {
"prompt": "A vibrant event poster with bold typography: SUMMER FEST 2026, colorful gradient background",
"aspect_ratio": "9:16",
"steps": 30,
"guidance": 4,
"output_format": "png",
"output_quality": 90,
"safety_tolerance": 2
}
}'
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-flex',
promptObject: {
prompt: 'A vibrant event poster with bold typography: SUMMER FEST 2026, colorful gradient background',
aspect_ratio: '9:16',
steps: 30,
guidance: 4,
output_format: 'png',
output_quality: 90,
safety_tolerance: 2
}
})
})
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-flex",
"promptObject": {
"prompt": "A vibrant event poster with bold typography: SUMMER FEST 2026, colorful gradient background",
"aspect_ratio": "9:16",
"steps": 30,
"guidance": 4,
"output_format": "png",
"output_quality": 90,
"safety_tolerance": 2
}
}
response = requests.post(url, headers=headers, json=data)
Interactive Playground
API Playground
https://api.1min.ai/api/featuresDescribe the image you want to generate
Diffusion steps: 6-10 for speed, 20-50 for quality
Prompt adherence scale (2-5)
Content safety threshold (1=strictest, 6=most permissive)
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-flex",
"promptObject": {
"prompt": "A vibrant event poster with bold typography: SUMMER FEST 2026, colorful gradient background",
"aspect_ratio": "9:16",
"steps": 30,
"guidance": 4,
"output_format": "png",
"output_quality": 90,
"safety_tolerance": 2
}
}'
Response Format
{
"aiRecord": {
"uuid": "e5f6a7b8-c9d0-1234-efab-345678901234",
"model": "black-forest-labs/flux-2-flex",
"type": "IMAGE_GENERATOR",
"status": "SUCCESS",
"createdAt": "2026-03-27T10:00:00.000Z",
"aiRecordDetail": {
"promptObject": {
"prompt": "A vibrant event poster with bold typography: SUMMER FEST 2026, colorful gradient background",
"aspect_ratio": "9:16",
"steps": 30,
"guidance": 4,
"output_format": "png",
"output_quality": 90,
"safety_tolerance": 2
},
"resultObject": [
"development/images/2026_03_27_10_00_05_001_poster.png"
]
},
"temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2026_03_27_10_00_05_001_poster.png?..."
}
}
Use Cases
- Typography & Design: Posters, infographics, and UI mockups with sharp text rendering
- Style Transfer: Multi-reference blending for consistent visual style
- Flexible Production: Tune quality vs speed by adjusting steps
- Brand Assets: Design-heavy materials requiring readable text and fine detail