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.
Get API Key
Create auth keys for apps and agents
See Usage
Track requests, credits, and logs
Buy Credits
Top up prepaid API capacity
API Endpoint
/api/v1/models/flux-3-image/runTest 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.
LLM.txt
For AI assistants
Copy this model's documentation into Claude, GPT, or any AI for instant integration help.
/llm/flux-3-image.txtOpenAPI Spec
Swagger compatible
Import into Postman, Swagger UI, or generate client SDKs in any language.
/api/openapiParameters
Input parameters accepted by this model
| Parameter | Type | Default |
|---|---|---|
promptrequired | string | - |
image_urls | array | - |
resolution | enum | 1k |
aspect_ratio | enum | auto |
grounding | boolean | true |
output_format | enum | jpg |
Use saved characters (@Name)
@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
See also
Related endpoints on this model. You may need a different apiId for a different operation (e.g. image edit vs generation).
- Same family, video/api/v1/models/flux-3-video/run
Example Outputs
Real outputs generated by this model
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
Underwater photo of a sea turtle swimming over a coral reef, sun rays piercing the surface
Close-up of hands kneading sourdough on a floured board, rustic bakery, soft side light
Electric pickup truck parked at a mountain overlook campsite at dusk, tent glowing, string lights
Snowy Kyoto temple with red torii gates, a lone figure with an umbrella, quiet winter morning
Portrait of a chef plating a dessert in a busy restaurant kitchen, focused expression, warm tungsten light
A vintage film camera and rolls of film on a wooden desk next to printed photographs, nostalgic mood
Hot air balloons rising over Cappadocia fairy chimneys at dawn, pastel sky
Modern minimalist kitchen with concrete island and brass fixtures, architectural photography, natural light
A golden retriever puppy running through autumn leaves in a park, backlit, motion frozen
Cozy bookstore cafe on a rainy afternoon, customers reading, warm lamps, rain-streaked windows
Lighthouse on a cliff during a storm, huge waves crashing, dramatic sky, long exposure
Glass skincare bottle on a wet slate stone surrounded by eucalyptus leaves, studio lighting, water droplets
A young violinist practicing in an empty concert hall, single spotlight, dust in the beam
Overhead flat lay of a Japanese breakfast: grilled salmon, miso soup, rice, pickles on dark wood, soft daylight
Wide shot of the Dolomites at blue hour, a lit mountain hut below jagged peaks, stars appearing
A pair of white running sneakers floating mid-air over a desert dune, hard sunlight, long shadows, advertising photo
Street food vendor in Bangkok at night grilling satay, smoke and neon signs, candid documentary style
Interior of a Scandinavian cabin living room, wood stove burning, snow falling outside floor-to-ceiling windows, cozy evening light
A red vintage Vespa parked on a narrow cobblestone street in Rome, laundry lines overhead, golden hour
Macro photo of a dewdrop on a fern frond reflecting a forest, crisp detail, bokeh background
Product shot of a matte black espresso machine on a marble counter, morning sunlight, steam rising from a fresh cup
A ceramicist trimming a bowl on a potter's wheel, late afternoon window light, clay dust hanging in the air, shot on 50mm
Close-up portrait of an elderly fisherman in Lofoten, weathered skin, wool sweater, soft overcast light, shallow depth of field
Aerial view of terraced rice fields in Bali at sunrise, mist pooling in the valleys, a single farmer in a conical hat
A ceramicist trimming a bowl on a wheel, late afternoon window light
Code Examples
Text-to-image: copy and paste to get started
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)
{
"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
{
"jobId": "job_abc123...",
"status": "completed",
"output": {
"images": [
"https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.png"
]
},
"creditCost": 1,
"expiresAt": "2026-11-12T16:17:11Z"
}