Flux Schnell - Image Generator
Ultra-fast AI image generation model by Black Forest Labs. Flux Schnell delivers rapid image generation optimized for speed with 1-4 inference steps, perfect for quick iterations, prototyping, and real-time applications.
Endpoint
Request Headers
| Field | Value |
|---|---|
| API-KEY | <api-key> |
| Content-Type | application/json |
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
type | string | Yes | Feature type identifier. Must be IMAGE_GENERATOR |
model | string | Yes | AI model identifier. Must be black-forest-labs/flux-schnell |
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, custom) | 1:1 |
output_quality | number | No | Output image quality (0-100) | 80 |
num_inference_steps | number | No | Number of inference steps (1-4) | 4 |
megapixels | string | No | Output resolution in megapixels (0.25, 1) | 1 |
go_fast | boolean | No | Enable fastest generation mode | true |
disable_safety_checker | boolean | No | Disable built-in safety filtering | false |
seed | number | No | Random seed for reproducibility (0-4294967295) | Random |
Supported Aspect Ratios
| Ratio | Use Case |
|---|---|
| 1:1 | Square images, social media posts |
| 16:9 | Widescreen, video thumbnails |
| 9:16 | Vertical video, mobile screens |
| 3:2 | Standard photography |
| 2:3 | Portrait photography |
| 4:5 | Instagram posts |
| 5:4 | Landscape photography |
| custom | Use specific width/height values |
Speed Settings
| Setting | Range | Description |
|---|---|---|
| Inference Steps | 1-4 | Fewer steps = faster generation (optimized for speed) |
| Go Fast | true/false | Enable maximum speed mode |
| Megapixels | 0.25, 1 | Output resolution (0.25 = ~512×512, 1 = ~1024×1024) |
| Output Quality | 0-100 | Image compression quality for final output |
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-schnell",
"promptObject": {
"prompt": "Modern minimalist logo design, clean lines, professional",
"aspect_ratio": "1:1",
"num_inference_steps": 4,
"go_fast": true,
"megapixels": "1",
"output_quality": 80
}
}'
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-schnell',
promptObject: {
prompt: 'Modern minimalist logo design, clean lines, professional',
aspect_ratio: '1:1',
num_inference_steps: 4,
go_fast: true,
megapixels: '1',
output_quality: 80
}
})
})
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-schnell",
"promptObject": {
"prompt": "Modern minimalist logo design, clean lines, professional",
"aspect_ratio": "1:1",
"num_inference_steps": 4,
"go_fast": True,
"megapixels": "1",
"output_quality": 80
}
}
response = requests.post(url, headers=headers, json=data)
Interactive Playground
API Playground
https://api.1min.ai/api/featuresDescribe the image you want to generate
Choose aspect ratio for your image
Number of inference steps (1-4, optimized for speed)
Output resolution in megapixels
Enable fastest generation mode
Disable built-in safety filtering
Output image quality (0-100)
Random seed for reproducibility (0-4294967295)
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-schnell",
"promptObject": {
"prompt": "Modern minimalist logo design, clean lines, professional",
"aspect_ratio": "1:1",
"num_inference_steps": 4,
"go_fast": true,
"megapixels": "1",
"output_quality": 80
}
}'
Response Format
{
"aiRecord": {
"uuid": "90a25e99-a544-42aa-bcd2-ee2c9a860cfe",
"userId": "c937fbcc-fa8f-4565-a440-c4d87f56fcb2",
"teamId": "a4e176b2-dabb-451e-9c58-62b451fa9630",
"teamUser": {
"teamId": "a4e176b2-dabb-451e-9c58-62b451fa9630",
"userId": "c937fbcc-fa8f-4565-a440-c4d87f56fcb2",
"userName": "John Doe",
"userAvatar": "https://lh3.googleusercontent.com/a/ACg8ocLqgsNsHRfmWF9d-E1RvJetVsEzxNOsOg-NXWNTpMxLDPJbwELI=s96-c",
"status": "ACTIVE",
"role": "ADMIN",
"creditLimit": 100000000,
"usedCredit": 2450205,
"createdAt": "2025-10-20T04:13:40.847Z",
"createdBy": "SYSTEM",
"updatedAt": "2025-10-24T08:09:25.898Z",
"updatedBy": "SYSTEM"
},
"model": "black-forest-labs/flux-schnell",
"type": "IMAGE_GENERATOR",
"metadata": null,
"rating": null,
"feedback": null,
"conversationId": null,
"status": "SUCCESS",
"createdAt": "2025-10-24T08:13:08.750Z",
"aiRecordDetail": {
"promptObject": {
"prompt": "Modern minimalist logo design, clean lines, professional",
"go_fast": true,
"megapixels": "1",
"aspect_ratio": "1:1",
"output_quality": 80,
"num_inference_steps": 4
},
"resultObject": [
"development/images/2025_10_24_15_13_11_086_302437.undefined"
],
"responseObject": {}
},
"additionalData": null,
"temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2025_10_24_15_13_11_086_302437.undefined?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAVRUVQEFIHSKAXGE7%2F20251024%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20251024T081312Z&X-Amz-Expires=604800&X-Amz-Signature=1e1ade1d732bea11309222e9622dad770d8acb7363113a237d2931bb2c337518&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
}
}
Use Cases
- Rapid Prototyping: Quick concept visualization and design iteration
- Real-time Applications: Interactive tools requiring fast image generation
- Batch Processing: Generate multiple variations quickly
- Mobile Applications: Fast generation for mobile and web apps
- Creative Exploration: Quick testing of different visual concepts
Tips for Best Results
-
Speed Optimization:
- Use 4 steps for best quality-to-speed ratio
- Enable "Go Fast" for maximum speed
- Use 1-2 steps for ultra-fast drafts
-
Quality vs Speed:
- 1 MP for final outputs
- 0.25 MP for rapid iterations
- Higher quality settings increase generation time slightly
-
Prompt Strategy:
- Keep prompts concise for faster processing
- Focus on key visual elements
- Use clear, descriptive language
Notes
Quality Trade-off
While extremely fast, this model may have lower detail compared to Flux Pro or Flux Dev. Use for rapid iterations and prototyping.