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 |
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
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-10-03T08:23:24Z"
}Completed Response
{
"jobId": "job_abc123...",
"status": "completed",
"output": {
"images": [
"https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.png"
]
},
"creditCost": 1,
"expiresAt": "2026-10-03T08:23:24Z"
}