GET

/v1/schemas/fal/image/fal-ai/lumina-image/v2

kind inputactivity imagehash c247a6cd…extracted Aug 10, 2026version currentsource upstream spec ↗
fieldrecorded source
schemaSource linked above.
Source trace
8a9559a8da0724e405077b6933cabe1159693b27f9f1186c864ebb583fc1e030
{
  "fetchedAt": 1786338105,
  "extractorVersion": "1",
  "verifiedAt": null
}

Request body

13 properties · 1 required · 1 $defs
propertytypedescriptionconstraints
prompt*stringThe prompt to generate an image from.
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
negative_promptstringThe negative prompt to use. Use it to address details that you don't want in the image. This could be colors, objects, scenery and even the small details (e.g. moustache, blurry, low resolution).default: ""
seedinteger The same seed and the same prompt given to the same version of the model will output the same image every time. nullable
cfg_trunc_rationumberThe ratio of the timestep interval to apply normalization-based guidance scale.0 ≤ n ≤ 1 · default: 1
num_inference_stepsintegerThe number of inference steps to perform.1 ≤ n ≤ 50 · default: 30
enable_safety_checkerbooleanIf set to true, the safety checker will be enabled. Disabling it requires account authorization; unauthorized requests are always checked.default: true
image_sizeImageSize | enumThe size of the generated image.default: "landscape_4_3"
cfg_normalizationbooleanWhether to apply normalization-based guidance scale.default: true
system_promptstringThe system prompt to use.default: "You are an assistant designed t…
guidance_scalenumberThe CFG (Classifier Free Guidance) 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: 4
output_formatenumThe format of the generated image.jpeg | png · default: "jpeg"
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/lumina-image/v2","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}