GET
/v1/schemas/fal/video/fal-ai/ltx-2.3-22b/text-to-video
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above.Source tracec4e9ff5697673b43a786c626482b7d961b9abb4e42dbda8127ed591e93eaa64c{
"fetchedAt": 1783330412,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
31 properties · 1 required · 1 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | The prompt to generate the video from. | |
| use_multiscale | boolean | Whether to use multi-scale generation. If True, the model will generate the video at a smaller scale first, then use the smaller video to guide the generation of a video at or above your requested size. This results in better coherence and details. | default: true |
| generate_audio | boolean | Whether to generate audio for the video. | default: true |
| enable_prompt_expansion | boolean | Whether to enable prompt expansion. | default: true |
| seed | integer | The seed for the random number generator. | nullable |
| audio_modality_scale | number | The modality scale for the audio. Controls the ratio between video and audio modalities. | 0 ≤ n ≤ 10 · default: 3 |
| video_cfg_scale | number | The Classifier-Free Guidance (CFG) scale for the video. Higher values result in more consistent and focused video content. | 1 ≤ n ≤ 20 · default: 3 |
| enable_safety_checker | boolean | Whether to enable the safety checker. | default: true |
| acceleration | enum | The acceleration level to use. | none | regular | high | full · default: "regular" |
| video_modality_scale | number | The modality scale for the video. Controls the ratio between video and audio modalities. | 0 ≤ n ≤ 10 · default: 3 |
| video_rescaling_scale | number | The rescaling scale for the video. Controls the ratio between classifier-free guidance and spatiotemporal guidance. | 0 ≤ n ≤ 1 · default: 0.7 |
| use_restart_sampling | boolean | Whether to use restart sampling. This will inject a small amount of noise during each denoising step, which can help improve the quality of the generated video. | default: false |
| num_frames | integer | The number of frames to generate. | 9 ≤ n ≤ 481 · default: 121 |
| num_inference_steps | integer | The number of inference steps to use. | 8 ≤ n ≤ 50 · default: 40 |
| distill_lora_second_pass_scale | number | The scale of the distill LoRA to use for the second and subsequent passes. | 0 ≤ n ≤ 1 · default: 0.5 |
| fps | number | The frames per second of the generated video. | 1 ≤ n ≤ 60 · default: 24 |
| scheduler | enum | The scheduler to use. | ltx2 | linear_quadratic | beta · default: "ltx2" |
| video_stg_scale | number | The Spatiotemporal Guidance (STG) scale for the video. Higher values result in more consistent and focused video content. | 0 ≤ n ≤ 20 · default: 0 |
| negative_prompt | string | The negative prompt to generate the video from. | default: "news broadcast, 3d animation, c… |
| audio_cfg_scale | number | The Classifier-Free Guidance (CFG) scale for the audio. Higher values result in more consistent and focused audio content. | 1 ≤ n ≤ 20 · default: 7 |
| audio_rescaling_scale | number | The rescaling scale for the audio. Controls the ratio between classifier-free guidance and spatiotemporal guidance. | 0 ≤ n ≤ 1 · default: 0.7 |
| video_output_type | enum | The output type of the generated video. | X264 (.mp4) | VP9 (.webm) | PRORES4444 (.mov) | GIF (.gif) · default: "X264 (.mp4)" |
| video_write_mode | enum | The write mode of the generated video. | fast | balanced | small · default: "balanced" |
| distill_lora_first_pass_scale | number | The scale of the distill LoRA to use for the first pass. Set to 0 to disable. | 0 ≤ n ≤ 1 · default: 0.2 |
| video_size | ImageSize | enum | The size of the generated video. | default: "landscape_16_9" |
| camera_lora | enum | The camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the model to move the camera. | dolly_in | dolly_out | dolly_left | dolly_right | jib_up | jib_down · +2 more · default: "none" |
| camera_lora_scale | number | The scale of the camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the model to move the camera. | 0 ≤ n ≤ 1 · default: 1 |
| audio_stg_scale | number | The Spatiotemporal Guidance (STG) scale for the audio. Higher values result in more consistent and focused audio content. | 0 ≤ n ≤ 20 · default: 0 |
| video_quality | enum | The quality of the generated video. | low | medium | high | maximum · default: "high" |
| 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 |
| gradient_estimation_gamma | number | The gamma of gradient estimation during denoising. Set to 0 to disable. | 0 ≤ n ≤ 10 · default: 2 |
Types
1 $defsImageSizeobject
| height | integer | The height of the generated image. | 0 < n ≤ 14142 · default: 512 |
| width | integer | The width of the generated image. | 0 < n ≤ 14142 · default: 512 |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/ltx-2.3-22b/text-to-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}