FLUX 2 API — Multi-Reference Image Generation

Generate stunning 4MP images with FLUX 2 from Black Forest Labs through VicSee API. Multi-reference consistency, superior text rendering, Pro and Flex modes. 15-75 credits.

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/generate

See 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`
input.prompt	string	Yes	Detailed description (3-5000 characters)
input.resolution	string	No	`1K` or `2K` (default: 1K)
input.aspect_ratio	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",
    "input": {
      "prompt": "A professional product photo of a luxury watch on a marble surface, studio lighting, soft shadows, high-end commercial photography",
      "resolution": "2K",
      "aspect_ratio": "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",
    "input": {
      "prompt": "Hyperrealistic portrait with fine skin texture, studio lighting, shallow depth of field, 85mm lens, fashion photography",
      "resolution": "2K",
      "aspect_ratio": "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`
input.prompt	string	Yes	Description of the output image
input.image_urls	array	Yes	Array of image URLs (1-8 images)
input.resolution	string	No	`1K` or `2K` (default: 1K)
input.aspect_ratio	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",
    "input": {
      "prompt": "The same character from the reference images, now standing in a futuristic cityscape at sunset",
      "image_urls": [
        "https://example.com/character-ref-1.jpg",
        "https://example.com/character-ref-2.jpg",
        "https://example.com/character-ref-3.jpg"
      ],
      "resolution": "2K",
      "aspect_ratio": "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)

{
  "success": true,
  "data": {
    "id": "task_abc123xyz",
    "model": "flux-2-pro-text-to-image",
    "status": "pending",
    "creditsUsed": 15,
    "creditsRemaining": 985,
    "createdAt": "2026-02-11T12: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

Nano Banana Pro - HD images up to 4K, better text rendering
Nano Banana - Fast standard-resolution images

FLUX 2

On this page