Skip to main content

FLUX 3 Image

FLUX 3 Text to Image

Generate an image from a prompt with one request.

Quickstart

Send a prompt to generate an image. This one produces a risograph illustration of a rabbit riding a pumpkin:
A two-color risograph illustration of a green rabbit riding a large orange pumpkin down a winding path through rolling hills.
Set BFL_API_KEY to a key from the BFL dashboard, then submit:
Poll the returned polling_url until status is Ready:
cURL
When status is Ready, download the image from result.sample.
The signed URL in result.sample expires after 1 hour. Download the image right away rather than storing the URL, and don’t send your x-key header to it.
Each client submits the Quickstart prompt, polls until the task finishes, and saves the image. The Python generate() function is used in the examples below. The cURL client requires jq.
Send only prompt to generate a new image. When you add images, describe how to use them in prompt. There is no mode field.The endpoint rejects unknown fields with HTTP 422, so fields from other BFL endpoints, such as seed, width, and input_image, don’t work here. The API reference lists every accepted field.

Text to image

Describe the subject, setting, light, and framing in prompt.
Two red pandas resting on bamboo beams among green leaves, one alert and one asleep.
To put text in the image, quote it exactly and say where it goes, for example a paper poster on the wall that reads "OPEN LATE". To choose where each element appears, add bounding boxes to the end of the prompt. The prompting guide covers structure, style, lighting, and typography in depth.

Examples

Each image below was generated with FLUX 3 Image. Copy its prompt to start from it.

Photorealistic

Typography & Design

Infographics

Illustration

Results and errors

The submit response returns immediately with id, polling_url, cost, input_mp, and output_mp. Always poll the returned polling_url. It points at the region that holds your task, so don’t build the URL yourself.A Ready result also includes result.prompt, the expanded prompt the model used, and result.duration, the generation time in seconds. Read result.prompt to see how FLUX 3 interpreted a short prompt or an edit.A failed task can come back as HTTP 503 with a normal JSON body. Read status from the body before treating a 503 as a retryable outage. Submission errors specific to this endpoint:For 402 (out of credits), 429 (rate limited), and other codes shared by every endpoint, see Errors. To run many requests in production, see the integration guidelines.

Keep exploring

Try in Playground

Try FLUX 3 Image in your browser, with no code.

Prompting guide

Structure, style, lighting, text, and editing prompts for FLUX 3.

API reference

The full request schema, limits, and response codes.

Bounding boxes

Place each element with a box, then edit box by box.

FLUX 3 Image overview

Sample images and what the model can do.

FLUX 3 Image Editing

Place elements and target edits with bounding boxes.