Skip to main content

Price drop on WAN and Seedream! WAN 3.0 is now 2 credits a second at 720p, WAN 3.0 Fast is 3 at 720p and 6 at 1080p, and WAN 2.7 Image to Video is 3 a second at 720p. Seedream 5 Pro is now 2.5 credits per image (1.25 at 1K), and Seedream 4.5 and Seedream 5 Lite are back to 1 credit. Details: pixeldojo.ai/changelog

Veo 3.1 20% off through October 8

Back to API Platform

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.

Image Generation
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

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: 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-10-03T08:23:24Z"
}

Completed Response

json
{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "images": [
      "https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.png"
    ]
  },
  "creditCost": 1,
  "expiresAt": "2026-10-03T08:23:24Z"
}