LTX-2.3 22B Distilled
/v1/runLtx 2.3 22b Distilled Audio To Video by Lightricks - advanced AI model for audio-to-video. Delivers high-quality results with fast inference, suitable for both creative and production workflows.
Request body
Submit an async generation request. The model field selects the model; other fields are model-specific input parameters.
Model identifier. Set to lightricks/ltx-2.3-22b/distilled/audio-to-video/lora.
Default: lightricks/ltx-2.3-22b/distilled/audio-to-video/lora
The prompt to generate the video from.
Optional URL of an image to use as the first frame of the video.
The URL of the image to use as the end of the video.
The URL of the audio to generate the video from.
The output type of the generated video.
Allowed values: X264 (.mp4), VP9 (.webm), PRORES4444 (.mov), GIF (.gif)
Default: X264 (.mp4)
The frames per second of the generated video.
Range: 1 to 60
Default: 24
The scale of the distill LoRA to use for the second and subsequent passes.
Range: 0 to 1
Default: 0.5
When enabled, the number of frames will be calculated based on the audio duration and FPS. When disabled, use the specified num_frames.
Default: true
The quality of the generated video.
Allowed values: low, medium, high, maximum
Default: high
The size of the generated video. Use 'auto' to match the input image dimensions if provided.
Allowed values: auto, square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9
Default: landscape_16_9
The LoRAs to use for the generation.
The strength of the image to use for the video generation.
Range: 0 to 1
Default: 1
The number of frames to generate.
Range: 9 to 481
Default: 121
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.
Range: 0 to 1
Default: 1
Audio conditioning strength. Values below 1.0 will allow the model to change the audio, while a value of exactly 1.0 will use the input audio without modification.
Range: 0 to 1
Default: 1
The strength of the end image to use for the video generation.
Range: 0 to 1
Default: 1
The write mode of the generated video.
Allowed values: fast, balanced, small
Default: balanced
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
The scheduler to use.
Allowed values: ltx2, linear_quadratic, beta
Default: ltx2
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.
Allowed values: dolly_in, dolly_out, dolly_left, dolly_right, jib_up, jib_down, static, none
Default: none
Whether to preprocess the audio before using it as conditioning.
Default: true
The seed for the random number generator.
Response Schema
The submit endpoint returns a run response. If its status is pending or running, poll GET /v1/run/{id} with the returned opaque ID until it reaches a terminal state.
Opaque SandBase run identifier. Use it exactly as returned; no prefix is guaranteed.
Current public run status.
Allowed values: pending, running, completed, failed, timeout
Public SandBase model name used for this run.
Present only for completed runs. Each object is capability-specific; inspect the selected model schema for its fields.
Present only for failed or timeout runs. Contains a public error type and sanitized message.
Stable public error category.
Sanitized error message safe to show to clients.
Usage details when available.
Model capabilities
Capabilities declared by the model registry.
Default: audio-to-video
Execution mode declared by the model registry.
Default: async