BFbfl
Models

Generate or edit an image with FLUX.2 [pro] (preview)

Changed on

Submits an image generation or editing task with the FLUX.2 [pro] preview endpoint, where our latest quality and speed improvements land first. For stable production use, prefer FLUX.2 [pro] (/flux-2-pro).

post/v1/flux-2-pro-preview

Request

Request body

userstring nullable

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

promptstring required

Text prompt for image generation.

disable_pupboolean

Disable automatic prompt upsampling for this request. FLUX.2 [pro] and [max] apply prompt upsampling by default; set this to true to generate from your prompt exactly as written.

input_imagestring nullable

Path to the input image.

input_image_2string nullable

Path to the second input image.

input_image_3string nullable

Path to the third input image.

input_image_4string nullable

Path to the fourth input image.

input_image_5string nullable

Path to the fifth input image.

input_image_6string nullable

Path to the sixth input image.

input_image_7string nullable

Path to the seventh input image.

input_image_8string nullable

Path to the eighth input image.

seedinteger nullable

Optional seed for reproducibility.

widthinteger nullable

Width of the image

heightinteger nullable

Height of the image

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.

output_format'jpeg' | 'png' | 'webp'
webhook_urlstring uri nullable

URL to receive webhook notifications

webhook_secretstring nullable

Optional secret for webhook signature verification

Example request

{
  "prompt": "ein fantastisches bild",
  "seed": 42
}

Response

Successful Response

OR

Changes