Skip to main content
Back to API Platform

Flux 2 Max API

The highest fidelity image model from Black Forest Labs Integrate this model via REST with endpoint docs, parameters, and code examples.

Image Generation
Img2Img
LoRA
Editing
Content moderation disabled
Credit Cost
2 credits
Type
image

API Endpoint

POST
/api/v1/models/flux-2-max/run

Parameters

Input parameters accepted by this model

ParameterTypeDefault
prompt
required
string
-
aspect_ratio
enum
1:1
resolution
enum
1 MP
num_outputs
integer
1
safety_tolerance
integer
5
prompt_upsampling
boolean
false
seed
integer
-
output_format
enum
png

Supported Aspect Ratios

1:1
16:9
9:16
3:2
2:3
4:5
5:4
3:4
4:3

Example Outputs

Real outputs generated by this model

A dramatic low-angle photograph of a master martial artist mid-strike inside a sleek modern dojo, shattering a wooden board that explodes into thousands of glowing purple and pink pixel fragments that scatter through the air like embers. The dojo has polished concrete floors, floor-to-ceiling windows revealing a rain-soaked Tokyo cityscape at night, and minimal Japanese architectural details — clean wooden beams, a torii gate silhouette visible through the glass. The pixel fragments cast colored light across the fighter's face and the wet floor reflections. Shot on Sony A7R V, 35mm f/1.4, shallow depth of field, dramatic side lighting from a single overhead spotlight cutting through atmospheric haze, rain streaks visible on the windows. Hyperrealistic, editorial photography, 8K resolution
View Details

A dramatic low-angle photograph of a master martial artist mid-strike inside a sleek modern dojo, shattering a wooden board that explodes into thousands of glowing purple and pink pixel fragments that scatter through the air like embers. The dojo has polished concrete floors, floor-to-ceiling windows revealing a rain-soaked Tokyo cityscape at night, and minimal Japanese architectural details — clean wooden beams, a torii gate silhouette visible through the glass. The pixel fragments cast colored light across the fighter's face and the wet floor reflections. Shot on Sony A7R V, 35mm f/1.4, shallow depth of field, dramatic side lighting from a single overhead spotlight cutting through atmospheric haze, rain streaks visible on the windows. Hyperrealistic, editorial photography, 8K resolution

2 credits
43.6s
{ "shot": { "composition": "wide shot centered at eye level, capturing the full view of the factory floor and the assembling motorbike", "lens": "35mm", "frame_rate": "24fps", "camera_movement": "static" }, "subject": { "description": "a futuristic, strong motorbike assembling itself from scattered parts", "wardrobe": "", "props": "mechanical parts, gears, wires, pistons, body panels, wheels" }, "scene": { "location": "large, clear industrial factory floor", "time_of_day": "midday", "environment": "shiny, clean surfaces with strong light and dramatic shadows; the atmosphere is warm and filled with subtle ambient haze" }, "visual_details": { "action": "motorbike parts fly in from all directions, clicking and locking into place to form a complete, sleek vehicle", "special_effects": "electric zaps, soft glows, heat distortion waves rising from the exhaust", "hair_clothing_motion": "" }, "cinematography": { "lighting": "bright overhead industrial lighting with sharp contrast, emphasizing form and texture", "color_palette": "warm tones with metallic highlights and soft amber reflections", "tone": "epic and intense, emphasizing mechanical precision and power" }, "audio": { "music": "minimalist, deep synthetic pulses that build with the assembly", "ambient": "deep factory hum, subtle air movements", "sound_effects": "clicks, whirs, zaps, shinks, thuds, whooshes, crackles, hiss, rumble", "mix_level": "cinematic mix with prioritized effects and balanced music bed" }, "dialogue": { "character": "", "line": "", "subtitles": false } }
View Details

{ "shot": { "composition": "wide shot centered at eye level, capturing the full view of the factory floor and the assembling motorbike", "lens": "35mm", "frame_rate": "24fps", "camera_movement": "static" }, "subject": { "description": "a futuristic, strong motorbike assembling itself from scattered parts", "wardrobe": "", "props": "mechanical parts, gears, wires, pistons, body panels, wheels" }, "scene": { "location": "large, clear industrial factory floor", "time_of_day": "midday", "environment": "shiny, clean surfaces with strong light and dramatic shadows; the atmosphere is warm and filled with subtle ambient haze" }, "visual_details": { "action": "motorbike parts fly in from all directions, clicking and locking into place to form a complete, sleek vehicle", "special_effects": "electric zaps, soft glows, heat distortion waves rising from the exhaust", "hair_clothing_motion": "" }, "cinematography": { "lighting": "bright overhead industrial lighting with sharp contrast, emphasizing form and texture", "color_palette": "warm tones with metallic highlights and soft amber reflections", "tone": "epic and intense, emphasizing mechanical precision and power" }, "audio": { "music": "minimalist, deep synthetic pulses that build with the assembly", "ambient": "deep factory hum, subtle air movements", "sound_effects": "clicks, whirs, zaps, shinks, thuds, whooshes, crackles, hiss, rumble", "mix_level": "cinematic mix with prioritized effects and balanced music bed" }, "dialogue": { "character": "", "line": "", "subtitles": false } }

2 credits
44.2s

Code Examples

Copy and paste to get started

bash
curl -X POST "https://pixeldojo.ai/api/v1/models/flux-2-max/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A beautiful mountain landscape at golden hour",
    "aspect_ratio": "1:1"
  }'

Response Format

Submit Response (202 Accepted)

json
{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 2,
  "creditsRemaining": 95,
  "expiresAt": "2025-01-23T12:00:00Z"
}

Completed Response

json
{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "images": [
      "https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.png"
    ]
  },
  "creditCost": 2,
  "expiresAt": "2025-01-23T12:00:00Z"
}