v1

latestOpenAPI 3.1.02026-07-267724480.0 KB

flux generate image

post/flux/v1/{model}

modelstring required

Flux model variant to use, e.g. flux-pro-1.1, flux-pro, flux-dev, flux-pro-1.1-ultra.

Content-Typestring

Must be application/json.

promptstring required

Text prompt describing the image to generate.

image_promptstring

URL of a reference image to guide the generation style or content.

widthinteger

Output image width in pixels. Must be a multiple of 32. Range varies by model.

heightinteger

Output image height in pixels. Must be a multiple of 32. Range varies by model.

stepsinteger

Number of diffusion steps. Higher values improve quality but increase latency.

prompt_upsamplingboolean

When true, automatically enhances the prompt for more detailed results.

seedinteger

Random seed for reproducible outputs. Omit for random generation.

guidancenumber

Guidance scale controlling how closely the output follows the prompt. Higher values increase prompt adherence.

safety_toleranceinteger

Safety filter tolerance level. Higher values are more permissive. Range: 0–6.

intervalinteger

Diversity interval. Higher values produce more varied outputs at the cost of prompt adherence.

output_formatstring

Output image format. Supported values: jpeg, png.

webhook_urlstring

URL to receive a POST notification when the task completes.

webhook_secretstring

Secret string included in webhook payloads for request verification.

idstring

Task id. Pass it to GET /flux/v1/get_result?id=....

polling_urlstring