GET

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

Accept:

kind inputactivity imagehash f83e74b0…extracted Aug 10, 2026version currentsource upstream spec ↗

field	recorded source
schema	Source linked above. Source trace `10bea3b42fad259f581f2dad04b13ff9df9083f484b12c8dba2b7b770d5b672b` { "fetchedAt": 1786338105, "extractorVersion": "1", "verifiedAt": null }

Request body

19 properties · 2 required · 1 $defs

property	type	description	constraints
image_url*	string	URL of image to be used for relighting
prompt*	string	The prompt to generate an image from.
enable_safety_checker	boolean	If set to true, the safety checker will be enabled. Disabling it requires account authorization; unauthorized requests are always checked.	default: true
enable_hr_fix	boolean	Use HR fix	default: false
negative_prompt	string	Negative Prompt for the image	default: ""
initial_latent	enum	Provide lighting conditions for the model	None \| Left \| Right \| Top \| Bottom · default: "None"
image_size	ImageSize \| enum	The size of the generated image.
mask_image_url	string	URL of mask to be used for ic-light conditioning image	nullable
cfg	number	The real classifier-free-guidance scale for the generation.	0.01 ≤ n ≤ 5 · default: 1
num_inference_steps	integer	The number of inference steps to perform.	1 ≤ n ≤ 50 · default: 28
output_format	enum	The format of the generated image.	jpeg \| png · default: "jpeg"
lowres_denoise	number	Strength for low-resolution pass.	0.01 ≤ n ≤ 1 · default: 0.98
seed	integer	The same seed and the same prompt given to the same version of the model will output the same image every time.	nullable
background_threshold	number	Threshold for the background removal algorithm. A high threshold will produce sharper masks. Note: This parameter is currently deprecated and has no effect on the output.	0.01 ≤ n ≤ 1 · default: 0.67
hr_downscale	number		0.01 ≤ n ≤ 1 · default: 0.5
num_images	integer	The number of images to generate.	1 ≤ n ≤ 4 · default: 1
highres_denoise	number	Strength for high-resolution pass. Only used if enable_hr_fix is True.	0.01 ≤ n ≤ 1 · default: 0.95
sync_mode	boolean	If `True`, the media will be returned as a data URI and the output data won't be available in the request history.	default: false
guidance_scale	number	The 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: 5

Types

1 $defs

ImageSizeobject

width	integer	The width of the generated image.	0 < n ≤ 14142 · default: 512
height	integer	The height 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/iclight-v2","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}