Models

Generate an image with FLUX 3.

Changed on

Submits an image generation task with FLUX 3.

post/v1/flux-3-image

Request

Request body

userstring nullable

Opaque identifier for the end user supplied by the calling platform.

promptstring required

Free-form prompt describing the image.

resolution'768sq' | '1k' | '1.5k' | '2k' | '4k' | 'match_input'

Image resolution class, an equal-pixel-area tier: 768sq, 1k (default), 1.5k, 2k, or 4k. Exact dimensions vary with the aspect ratio. match_input (edits only): the output keeps the first reference's own size (shrunk to 4 MP when larger), or its nearest tier when aspect_ratio is set. Ignored when width and height are set.

widthinteger nullable

Exact output width in pixels, [256, 6256]; set together with height. Overrides resolution and aspect_ratio.

heightinteger nullable

Exact output height in pixels, [256, 6256]; width x height at most 16822272 pixels, and at most 4194304 with reference images.

safety_toleranceinteger

Harm moderation tolerance from 0 to 7, with 0 the strictest. The route and organization determine the approved maximum and per-category ceilings. Unapproved levels return 422 with approved levels.

groundingboolean

When true (default) the prompt may be grounded in external research: web search and image search. When false, both are off.

version'latest'

Endpoint version. latest (default) serves the current release; dated pinnable release tags are added here as they are published.

Response

Successful Response

idstring required
polling_urlstring required
costnumber nullable

Cost in credits for this request

input_mpnumber nullable

Input megapixels (2 decimal places)

output_mpnumber nullable

Output megapixels (2 decimal places)

Changes

    • info

      added the new optional request property

    • info

      added the new optional request property

    • info

      added the new match_input enum value to the request property

    • info

      added the new optional request property