GET

/v1/schemas/fal/image/fal-ai/flux-2

kind inputactivity imagehash acd50110…extracted Aug 8, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.
Source trace
175d819c563e00b74d07c4383aefac5a46a00642f6ee0c7d4dc014fbac66dfac
{
  "fetchedAt": 1786165357,
  "extractorVersion": "1",
  "verifiedAt": null
}

Request body

11 properties · 1 required · 1 $defs
propertytypedescriptionconstraints
prompt*stringThe prompt to generate an image from.
num_inference_stepsintegerThe number of inference steps to perform.4 ≤ n ≤ 50 · default: 28
sync_modebooleanIf `True`, the media will be returned as a data URI and the output data won't be available in the request history.default: false
seedintegerThe seed to use for the generation. If not provided, a random seed will be used.nullable
enable_prompt_expansionbooleanIf set to true, the prompt will be expanded for better results.default: false
guidance_scalenumberGuidance Scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you.0 ≤ n ≤ 20 · default: 2.5
accelerationenumThe acceleration level to use for the image generation.none | regular | high · default: "regular"
image_sizeImageSize | enumThe size of the image to generate. The width and height must be between 512 and 2048 pixels.default: "landscape_4_3"
output_formatenumThe format of the generated image.jpeg | png | webp · default: "png"
enable_safety_checkerbooleanIf set to true, the safety checker will be enabled. Disabling it requires account authorization; unauthorized requests are always checked, and images flagged as unsafe are returned as black images.default: true
num_imagesintegerThe number of images to generate.1 ≤ n ≤ 4 · default: 1

Types

1 $defs

ImageSizeobject

heightintegerThe height of the generated image.0 < n ≤ 14142 · default: 512
widthintegerThe width of the generated image.0 < n ≤ 14142 · default: 512

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"fal-ai/flux-2","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}