GET
/v1/schemas/fal/video/fal-ai/ltx-2.3-22b/extend-video
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above.Source trace174d9b007f22f94b213221a0640114c967508c64a43cfd739221d3ddeaff5462{
"fetchedAt": 1783331098,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
39 properties · 2 required · 1 $defs| property | type | description | constraints |
|---|---|---|---|
| video_url* | string | The URL of the video to extend. | |
| prompt* | string | The prompt to generate the video from. | |
| video_strength | number | Video conditioning strength. Lower values represent more freedom given to the model to change the video content. | 0 ≤ n ≤ 1 · default: 1 |
| audio_strength | number | Audio conditioning strength. Lower values represent more freedom given to the model to change the audio content. | 0 ≤ n ≤ 1 · default: 1 |
| 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 |
| 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 |
| 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 |
| num_context_frames | integer | The number of frames to use as context for the extension. | 0 ≤ n ≤ 121 · default: 25 |
| scheduler | enum | The scheduler to use. | ltx2 | linear_quadratic | beta · default: "ltx2" |
| end_image_strength | number | The strength of the end image to use for the video generation. | 0 ≤ n ≤ 1 · default: 1 |
| 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: "auto" |
| 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" |
| end_image_url | string | The URL of the image to use as the end of the extended video. | nullable |
| extend_direction | enum | Direction to extend the video. 'forward' extends from the end of the video, 'backward' extends from the beginning. | forward | backward · default: "forward" |
| 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 |
| match_input_fps | boolean | When true, match the output FPS to the input video's FPS instead of using the default target FPS. | default: true |
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/extend-video","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}