GET

/v1/schemas/fal/video/fal-ai/lightx/relight

Accept:

kind inputactivity videohash 21cb80a0…extracted Oct 9, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. upstream-spec Source trace `bfb0b239efcdce20469308e870d71547c4c6424ecd20d577929ed3ad3af689b0` { "fetchedAt": 1791522002, "extractorVersion": "1", "verifiedAt": null }

Request body

8 properties · 1 required · 1 $defs

property	type	description	constraints
video_url*	string	URL of the input video.
relight_parameters	RelightParameters	Relighting parameters for video relighting operations.	nullable
relit_cond_type	enum	Relight condition type.	ic \| ref \| hdr \| bg · default: "ic"
ref_id	integer	Frame 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
prompt	string	Optional text prompt. If omitted, Light-X will auto-caption the video.	nullable
relit_cond_img_url	string	URL of conditioning image. Required for relight_condition_type='ref'/'hdr'. Also required for relight_condition_type='bg' (background image).	nullable
seed	integer	Random seed for reproducibility. If None, a random seed is chosen.	nullable
enable_safety_checker	boolean	Authorized callers may set false to request relaxed screening.	default: true

Types

1 $defs

RelightParametersobject

Relighting parameters for video relighting operations.

relight_prompt*	string	Text prompt describing the desired lighting condition.
bg_source	enum	Direction of the light source (used for IC-light).	Left \| Right \| Top \| Bottom · default: "Left"
use_sky_mask	boolean	Whether to use sky masking for outdoor scenes.	default: false
cfg	number	Classifier-free guidance scale for relighting.	1 ≤ n ≤ 10 · default: 2

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", …}]}