Skip to main content
Back to API Platform

Flux 2 Dev API

Fast quality with up to 4 reference images Integrate this model via REST with endpoint docs, parameters, and code examples.

Image Generation
Img2Img
LoRA
Editing
Content moderation disabled
Credit Cost
1 credit
Type
image

API Endpoint

POST
/api/v1/models/flux-2-dev/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

1 credits
6.4s
{ "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 } }

1 credits
6.6s

Code Examples

Copy and paste to get started

bash
curl -X POST "https://pixeldojo.ai/api/v1/models/flux-2-dev/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": 1,
  "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": 1,
  "expiresAt": "2025-01-23T12:00:00Z"
}