FLUX.2 API
Generate high-quality images with FLUX.2 from Black Forest Labs
FLUX.2
Generate stunning images with FLUX.2 from Black Forest Labs. FLUX.2 offers multi-reference consistency (up to 8 images), superior text rendering, strong prompt following, and 4MP resolution. Choose between Pro (fast) and Flex (quality) modes.
Try it now: Use the FLUX AI Generator to create images without writing code.
Model Variants
| Model | Best For | Speed | Credits |
|---|---|---|---|
| FLUX.2 Pro | Production workflows | Fast | 15-20 |
| FLUX.2 Flex | Maximum quality | Higher latency | 45-75 |
Pricing
| Variant | Resolution | Credits | Price (Pro Yearly) | Price (Pro Monthly) |
|---|---|---|---|---|
| FLUX.2 Pro | 1K | 15 | $0.09 | $0.18 |
| FLUX.2 Pro | 2K | 20 | $0.12 | $0.24 |
| FLUX.2 Flex | 1K | 45 | $0.27 | $0.54 |
| FLUX.2 Flex | 2K | 75 | $0.45 | $0.90 |
Credits are deducted only on successful generation.
Endpoint
POST https://vicsee.com/api/v1/generateSee Authentication for API key setup.
Text to Image
Generate images from text descriptions using FLUX.2.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| model | string | Yes | flux-2/pro-text-to-image or flux-2/flex-text-to-image |
| prompt | string | Yes | Detailed description (3-5000 characters) |
| options.resolution | string | No | 1K or 2K (default: 1K) |
| options.aspectRatio | string | No | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, auto |
Example Request (Pro)
curl -X POST https://vicsee.com/api/v1/generate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-2/pro-text-to-image",
"prompt": "A professional product photo of a luxury watch on a marble surface, studio lighting, soft shadows, high-end commercial photography",
"options": {
"resolution": "2K",
"aspectRatio": "1:1"
}
}'Example Request (Flex - Maximum Quality)
curl -X POST https://vicsee.com/api/v1/generate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-2/flex-text-to-image",
"prompt": "Hyperrealistic portrait with fine skin texture, studio lighting, shallow depth of field, 85mm lens, fashion photography",
"options": {
"resolution": "2K",
"aspectRatio": "3:4"
}
}'Image to Image (Multi-Reference)
Use reference images to maintain consistency across outputs. FLUX.2 supports up to 8 reference images for character, product, or style consistency.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| model | string | Yes | flux-2/pro-image-to-image or flux-2/flex-image-to-image |
| prompt | string | Yes | Description of the output image |
| options.inputUrls | array | Yes | Array of image URLs (1-8 images) |
| options.resolution | string | No | 1K or 2K (default: 1K) |
| options.aspectRatio | string | No | Output aspect ratio |
Example Request (Multi-Reference)
curl -X POST https://vicsee.com/api/v1/generate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "flux-2/pro-image-to-image",
"prompt": "The same character from the reference images, now standing in a futuristic cityscape at sunset",
"options": {
"inputUrls": [
"https://example.com/character-ref-1.jpg",
"https://example.com/character-ref-2.jpg",
"https://example.com/character-ref-3.jpg"
],
"resolution": "2K",
"aspectRatio": "16:9"
}
}'Key Features
Multi-Reference Consistency
Upload up to 8 reference images to maintain character, product, or style consistency across outputs. FLUX.2 excels at identity preservation even in complex scenes.
Superior Text Rendering
Unlike most image models, FLUX.2 handles typography well. Generate images with readable text, logos, and branded content.
Strong Prompt Following
Complex, multi-part prompts are executed accurately. Describe intricate scenes with specific positioning and detailed attributes.
Pro vs Flex: When to Use Each
| Use Case | Recommended Model |
|---|---|
| Quick iterations, drafts | FLUX.2 Pro |
| Production assets | FLUX.2 Pro |
| Maximum quality needed | FLUX.2 Flex |
| Fine art, portfolios | FLUX.2 Flex |
| Batch generation | FLUX.2 Pro |
Response
Success (200)
{
"taskId": "task_abc123xyz",
"status": "pending",
"model": "flux-2/pro-text-to-image",
"createdAt": "2025-12-29T12:00:00Z"
}Poll for completion using Tasks API.
Task Complete
{
"taskId": "task_abc123xyz",
"status": "completed",
"output": {
"url": "https://cdn.vicsee.com/outputs/image_xyz.png",
"width": 2048,
"height": 2048,
"format": "png"
}
}Error Codes
| Code | Message | Resolution |
|---|---|---|
| 400 | Invalid prompt | Prompt must be 3-5000 characters |
| 400 | Invalid resolution | Use 1K or 2K |
| 400 | Too many input images | Maximum 8 reference images |
| 402 | Insufficient credits | Top up your account |
Related Models
- Nano Banana Pro - HD images up to 4K, better text rendering
- Nano Banana - Fast standard-resolution images