GET

/v1/schemas/fal/video/fal-ai/ltx-2.3-quality/audio-to-video/lora

Accept:

kind inputactivity videohash 832682af…extracted Jul 6, 2026version currentsource upstream spec ↗

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

Request body

19 properties · 3 required · 2 $defs

property	type	description	constraints
audio_url*	string	The URL of the audio track that drives generation.
prompt*	string	The prompt to guide the audio-driven video generation.
loras*	LoRAInput[]	Up to 3 LoRAs to apply on top of LTX-2.3. Each path is downloaded through the registry SSRF-safe downloader before it is loaded. Max size: 3 GB per LoRA.	items ≤ 3
num_frames	integer	The number of frames to generate.	9 ≤ n ≤ 481 · default: 121
enable_prompt_expansion	boolean	Whether to enable prompt expansion.	default: true
frames_per_second	number	Frames per second of the generated video.	1 ≤ n ≤ 60 · default: 24
enable_safety_checker	boolean	Whether to enable the safety checker.	default: true
seed	integer	Random seed for reproducibility. If None, a random seed is chosen.	nullable
guidance_scale	number	Classifier-free guidance scale. The default is tuned for fast, high-quality generation.	1 ≤ n ≤ 20 · default: 1
sync_mode	boolean	If True, the media is returned as a data URI inline in the response. Useful for short-lived requests and tests.	default: false
num_inference_steps	integer	Number of inference steps. Defaults to 15 and can be increased up to 30.	8 ≤ n ≤ 30 · default: 15
image_strength	number	Conditioning strength for the optional first frame. 1.0 keeps the image more strictly; lower values give the model more freedom.	0 ≤ n ≤ 1 · default: 0.7
video_quality	enum	The quality preset of the generated video.	low \| medium \| high \| maximum · default: "high"
generate_audio	boolean	Whether to include audio in the returned video. When disabled, the final MP4 is returned without an audio track.	default: true
negative_prompt	string	The negative prompt to steer generation away from.	default: "color distortion, overexposure,…
resolution	ImageSize \| enum	Final output size. 'auto' matches the input image aspect ratio when image_url is provided; otherwise it uses a landscape fallback.	default: "auto"
match_audio_length	boolean	When enabled, derives the number of frames from the audio duration and frames_per_second. When disabled, uses num_frames.	default: true
video_write_mode	enum	The write mode of the generated video.	fast \| balanced \| small · default: "balanced"
image_url	string	Optional URL of an image to use as the first frame. When omitted, generation runs from text and audio only.	nullable

Types

2 $defs

ImageSizeobject

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

LoRAInputobject

A single LoRA to apply on top of the LTX-2.3 base model.

scale	number	Strength of the LoRA application (0.0 to 2.0). Higher values = stronger effect on the generated video.	0 ≤ n ≤ 2 · default: 1
path*	string	Direct HTTP(S) download URL of the LoRA file (.safetensors). The file is downloaded through an SSRF-safe downloader before it is loaded. Max size: 3 GB.	length ≤ 2048
transformer	enum	Forward-compatibility flag for multi-transformer architectures. LTX-2.3 has a single transformer, so 'both' is the right choice for almost all users.	high \| low \| both · default: "both"

Validate a payload

before you spend tokens

shell

$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"fal","endpointId":"fal-ai/ltx-2.3-quality/audio-to-video/lora","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}