Skip to main content

UNLIMITED

Flux 3 Klein, H3 Image, Qwen 2.1, MiniMax H3 Video, 310+ effectsSee plans

WAN WEEK 20% OFF through November 13

Back to API Platform

Image Generation

FLUX 3 Image API

Black Forest Labs FLUX 3: photoreal text-to-image up to 4K, edits with up to 10 reference images, and web-grounded generation for real products and places. Integrate this model via REST with endpoint docs, parameters, and code examples.

Img2Img
Editing
Credit Cost
1 credit
Type
Image

API Endpoint

POST
/api/v1/models/flux-3-image/run

Test This Model

Run a real request through the API pipeline and inspect the exact input and output your integration will handle. Uses your credits like any API call; failed runs are refunded automatically.

Parameters

Input parameters accepted by this model

ParameterTypeDefault
prompt
required
string
-
image_urls
array
-
resolution
enum
1k
aspect_ratio
enum
auto
grounding
boolean
true
output_format
enum
jpg

Use saved characters (@Name)

Write @Name in the prompt to use a character, product, outfit, location, prop or style saved in the account's Character Studio, for example "@Mara on a beach at sunset". Its photos are added to image_urls automatically, after any images you send yourself, so your own image numbering is unchanged. List saved names with GET /api/v1/characters and save new ones with POST /api/v1/characters. An @word that names nothing saved stays plain text.

Supported Aspect Ratios

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

See also

Related endpoints on this model. You may need a different apiId for a different operation (e.g. image edit vs generation).

Example Outputs

Real outputs generated by this model

FLUX 3 Image example: A cinematic side-profile portrait of an astronaut standing on a rocky alien beach at sunset, salt spray in the air, t...
View Details

A cinematic side-profile portrait of an astronaut standing on a rocky alien beach at sunset, salt spray in the air, twin suns glowing on the horizon, helmet visor catching warm orange light, weathered patches on the spacesuit. Anamorphic lens, soft rim light, sharp focus on the visor.

1 credit
22.6s
FLUX 3 Image example: Full-length street style photograph of a young woman in an oversized olive bomber, pleated plaid skirt and chunky boo...
View Details

Full-length street style photograph of a young woman in an oversized olive bomber, pleated plaid skirt and chunky boots, walking through a narrow Tokyo back alley at dusk, neon signs in pink and cyan reflecting on wet pavement. Kodak Portra 400 grain, 35mm lens, candid editorial.

1 credit
21.9s
FLUX 3 Image example: 1940s film noir scene: a detective in a fedora and trench coat in a dark office, hard light through venetian blinds s...
View Details

1940s film noir scene: a detective in a fedora and trench coat in a dark office, hard light through venetian blinds slicing stripes across his face and the wall, cigarette smoke curling into the beam, rain on the window behind. Black and white, deep blacks, hard chiaroscuro, anamorphic widescreen still.

1 credit
21.9s
FLUX 3 Image example: Professional studio headshot of a man in his forties in a navy blazer and open-collar white shirt, neutral grey paper...
View Details

Professional studio headshot of a man in his forties in a navy blazer and open-collar white shirt, neutral grey paper backdrop, soft beauty dish key light with a subtle catch light in sharp eyes, relaxed confident half smile. 85mm lens, natural skin texture, corporate portrait.

1 credit
18.8s
FLUX 3 Image example: A frosted glass perfume bottle with a brushed gold cap standing on a white Carrara marble counter, soft north window...
View Details

A frosted glass perfume bottle with a brushed gold cap standing on a white Carrara marble counter, soft north window daylight, a single sprig of eucalyptus beside it, a gentle reflection in the stone. Minimal editorial product photograph, 100mm lens, clean negative space.

1 credit
18.7s
FLUX 3 Image example: A white and volt-green running sneaker floating at a slight angle above a matte grey podium, sharp rim light from abo...
View Details

A white and volt-green running sneaker floating at a slight angle above a matte grey podium, sharp rim light from above outlining the mesh and sole, soft shadow below, seamless light grey studio background. High-end advertising product shot, every stitch in focus.

1 credit
15.7s
FLUX 3 Image example: Editorial fashion photograph of a model in a flowing ivory linen dress standing on red sandstone in the desert at gol...
View Details

Editorial fashion photograph of a model in a flowing ivory linen dress standing on red sandstone in the desert at golden hour, wind lifting the fabric and her hair, long shadows across rippled rock. Shot on medium format, Kodak Portra 400 tones, warm terracotta and cream palette, magazine cover quality.

1 credit
37.6s
FLUX 3 Image example: Editorial food photograph of seared scallops on a pale pea puree with micro herbs, plated on a hand-thrown grey stone...
View Details

Editorial food photograph of seared scallops on a pale pea puree with micro herbs, plated on a hand-thrown grey stoneware dish over a textured slate surface, soft north window light from the left, glossy sauce and dewy herbs. Shallow depth of field, 100mm macro, fine-dining cookbook style.

1 credit
31.2s
FLUX 3 Image example: A latte with rosetta foam art beside an open handwritten journal and a brass pen on a worn oak table, morning sun sla...
View Details

A latte with rosetta foam art beside an open handwritten journal and a brass pen on a worn oak table, morning sun slanting through a cafe window, steam catching the light, soft background bokeh of shelves and plants. Warm editorial lifestyle photograph, 50mm lens, gentle film grain.

1 credit
25.0s
FLUX 3 Image example: Wide shot from the back of a packed concert hall, a lone performer silhouetted at center stage against blinding white...
View Details

Wide shot from the back of a packed concert hall, a lone performer silhouetted at center stage against blinding white and magenta stage lights, beams cutting through thick haze, hundreds of raised phone screens glowing in the crowd. Photojournalism style, 35mm lens, natural lens flare, fine grain.

1 credit
25.0s
FLUX 3 Image example: Minimal Swiss-style poster: the black silhouette of a single wristwatch centered on warm off-white paper, a strict gr...
View Details

Minimal Swiss-style poster: the black silhouette of a single wristwatch centered on warm off-white paper, a strict grid with thin rules, oversized bold sans-serif letters reading "TIME" across the bottom third, small caption text in the top corner. Flat print texture, generous negative space.

1 credit
22.0s
FLUX 3 Image example: A modern glass-and-concrete house on a hillside at blue hour, warm interior light glowing through floor-to-ceiling wi...
View Details

A modern glass-and-concrete house on a hillside at blue hour, warm interior light glowing through floor-to-ceiling windows, the mirrored facade reflecting a deep indigo sky, long-exposure red and white car light trails curving along the road below. Shot on a 24mm tilt-shift lens, straight verticals, crisp detail, architectural magazine cover.

1 credit
18.8s
FLUX 3 Image example: Close-up portrait of a woman in her thirties by a window at golden hour, warm rim light tracing her cheek and loose s...
View Details

Close-up portrait of a woman in her thirties by a window at golden hour, warm rim light tracing her cheek and loose strands of hair, the rest of her face in soft shadow, calm direct gaze into the lens. Shot on an 85mm lens at f/1.8, creamy background bokeh, natural skin texture with fine pores, muted teal and amber film grade, subtle grain.

1 credit
19.4s
FLUX 3 Image example: Underwater photo of a sea turtle swimming over a coral reef, sun rays piercing the surface
View Details

Underwater photo of a sea turtle swimming over a coral reef, sun rays piercing the surface

1 credit
25.0s
FLUX 3 Image example: Close-up of hands kneading sourdough on a floured board, rustic bakery, soft side light
View Details

Close-up of hands kneading sourdough on a floured board, rustic bakery, soft side light

1 credit
25.2s
FLUX 3 Image example: Electric pickup truck parked at a mountain overlook campsite at dusk, tent glowing, string lights
View Details

Electric pickup truck parked at a mountain overlook campsite at dusk, tent glowing, string lights

1 credit
21.9s
FLUX 3 Image example: Snowy Kyoto temple with red torii gates, a lone figure with an umbrella, quiet winter morning
View Details

Snowy Kyoto temple with red torii gates, a lone figure with an umbrella, quiet winter morning

1 credit
25.8s
FLUX 3 Image example: Portrait of a chef plating a dessert in a busy restaurant kitchen, focused expression, warm tungsten light
View Details

Portrait of a chef plating a dessert in a busy restaurant kitchen, focused expression, warm tungsten light

1 credit
28.1s
FLUX 3 Image example: A vintage film camera and rolls of film on a wooden desk next to printed photographs, nostalgic mood
View Details

A vintage film camera and rolls of film on a wooden desk next to printed photographs, nostalgic mood

1 credit
22.3s
FLUX 3 Image example: Hot air balloons rising over Cappadocia fairy chimneys at dawn, pastel sky
View Details

Hot air balloons rising over Cappadocia fairy chimneys at dawn, pastel sky

1 credit
25.1s
FLUX 3 Image example: Modern minimalist kitchen with concrete island and brass fixtures, architectural photography, natural light
View Details

Modern minimalist kitchen with concrete island and brass fixtures, architectural photography, natural light

1 credit
25.4s
FLUX 3 Image example: A golden retriever puppy running through autumn leaves in a park, backlit, motion frozen
View Details

A golden retriever puppy running through autumn leaves in a park, backlit, motion frozen

1 credit
25.7s
FLUX 3 Image example: Cozy bookstore cafe on a rainy afternoon, customers reading, warm lamps, rain-streaked windows
View Details

Cozy bookstore cafe on a rainy afternoon, customers reading, warm lamps, rain-streaked windows

1 credit
25.6s
FLUX 3 Image example: Lighthouse on a cliff during a storm, huge waves crashing, dramatic sky, long exposure
View Details

Lighthouse on a cliff during a storm, huge waves crashing, dramatic sky, long exposure

1 credit
22.3s
FLUX 3 Image example: Glass skincare bottle on a wet slate stone surrounded by eucalyptus leaves, studio lighting, water droplets
View Details

Glass skincare bottle on a wet slate stone surrounded by eucalyptus leaves, studio lighting, water droplets

1 credit
22.5s
FLUX 3 Image example: A young violinist practicing in an empty concert hall, single spotlight, dust in the beam
View Details

A young violinist practicing in an empty concert hall, single spotlight, dust in the beam

1 credit
22.7s
FLUX 3 Image example: Overhead flat lay of a Japanese breakfast: grilled salmon, miso soup, rice, pickles on dark wood, soft daylight
View Details

Overhead flat lay of a Japanese breakfast: grilled salmon, miso soup, rice, pickles on dark wood, soft daylight

1 credit
25.7s
FLUX 3 Image example: Wide shot of the Dolomites at blue hour, a lit mountain hut below jagged peaks, stars appearing
View Details

Wide shot of the Dolomites at blue hour, a lit mountain hut below jagged peaks, stars appearing

1 credit
25.5s
FLUX 3 Image example: A pair of white running sneakers floating mid-air over a desert dune, hard sunlight, long shadows, advertising photo
View Details

A pair of white running sneakers floating mid-air over a desert dune, hard sunlight, long shadows, advertising photo

1 credit
25.0s
FLUX 3 Image example: Street food vendor in Bangkok at night grilling satay, smoke and neon signs, candid documentary style
View Details

Street food vendor in Bangkok at night grilling satay, smoke and neon signs, candid documentary style

1 credit
22.0s
FLUX 3 Image example: Interior of a Scandinavian cabin living room, wood stove burning, snow falling outside floor-to-ceiling windows, cozy...
View Details

Interior of a Scandinavian cabin living room, wood stove burning, snow falling outside floor-to-ceiling windows, cozy evening light

1 credit
25.1s
FLUX 3 Image example: A red vintage Vespa parked on a narrow cobblestone street in Rome, laundry lines overhead, golden hour
View Details

A red vintage Vespa parked on a narrow cobblestone street in Rome, laundry lines overhead, golden hour

1 credit
52.9s
FLUX 3 Image example: Macro photo of a dewdrop on a fern frond reflecting a forest, crisp detail, bokeh background
View Details

Macro photo of a dewdrop on a fern frond reflecting a forest, crisp detail, bokeh background

1 credit
34.3s
FLUX 3 Image example: Product shot of a matte black espresso machine on a marble counter, morning sunlight, steam rising from a fresh cup
View Details

Product shot of a matte black espresso machine on a marble counter, morning sunlight, steam rising from a fresh cup

1 credit
37.3s
FLUX 3 Image example: A ceramicist trimming a bowl on a potter's wheel, late afternoon window light, clay dust hanging in the air, shot on...
View Details

A ceramicist trimming a bowl on a potter's wheel, late afternoon window light, clay dust hanging in the air, shot on 50mm

1 credit
34.5s
FLUX 3 Image example: Close-up portrait of an elderly fisherman in Lofoten, weathered skin, wool sweater, soft overcast light, shallow dept...
View Details

Close-up portrait of an elderly fisherman in Lofoten, weathered skin, wool sweater, soft overcast light, shallow depth of field

1 credit
31.3s
FLUX 3 Image example: Aerial view of terraced rice fields in Bali at sunrise, mist pooling in the valleys, a single farmer in a conical hat
View Details

Aerial view of terraced rice fields in Bali at sunrise, mist pooling in the valleys, a single farmer in a conical hat

1 credit
25.2s
FLUX 3 Image example: A ceramicist trimming a bowl on a wheel, late afternoon window light
View Details

A ceramicist trimming a bowl on a wheel, late afternoon window light

1 credit
22.1s

Code Examples

Text-to-image: copy and paste to get started

bash
curl -X POST "https://pixeldojo.ai/api/v1/models/flux-3-image/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A ceramicist trimming a bowl on a wheel, late afternoon window light, clay dust in the air",
    "aspect_ratio": "16:9"
  }'

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": "2026-11-12T16:17:11Z"
}

Completed Response

json
{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "images": [
      "https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.png"
    ]
  },
  "creditCost": 1,
  "expiresAt": "2026-11-12T16:17:11Z"
}