GET

/v1/schemas/fal/video/fal-ai%2Flightx%2Frelight

kind inputactivity videohash 3f21a20bextracted Jul 6, 2026version currentsource upstream spec ↗

Request body

7 properties · 1 required · 1 $defs
propertytypedescriptionconstraints
video_url*stringURL of the input video.
seedintegerRandom seed for reproducibility. If None, a random seed is chosen.nullable
promptstringOptional text prompt. If omitted, Light-X will auto-caption the video.nullable
ref_idintegerFrame index to use as reference to relight the video with reference. Must be less than the number of generated frames (default 49).0 ≤ n ≤ 48 · default: 0
relit_cond_img_urlstringURL of conditioning image. Required for relight_condition_type='ref'/'hdr'. Also required for relight_condition_type='bg' (background image).nullable
relight_parametersRelightParametersRelighting parameters for video relighting operations.nullable
relit_cond_typeenumRelight condition type.ic | ref | hdr | bg · default: "ic"

Validate a payload

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