lightricks/ltx-2.3-quality/audio-to-video

Name: Ltx 2.3 Quality
Author: Lightricks

Ltx 2.3 Quality 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.

Input

Prompt(string)

The prompt to guide the audio-driven video generation.

Image URL or upload(string)

Upload

PNG, JPEG, WebP, or GIF · 20 MiB maximum

Optional URL of an image to use as the first frame. When omitted, generation runs from text and audio only.

This field is required.

Audio URL(string)

The URL of the audio track that drives generation.

Resolution(string)

Final output size. 'auto' matches the input image aspect ratio when image_url is provided; otherwise it uses a landscape fallback. Allowed values: auto, square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9.

Generate Audio(boolean)

Whether to include audio in the returned video. When disabled, the final MP4 is returned without an audio track.

Guidance Scale(number)

120

Classifier-free guidance scale. The default is tuned for fast, high-quality generation. Range: 1 to 20.

Number of Inference Steps(integer)

830

Number of inference steps. Defaults to 15 and can be increased up to 30. Range: 8 to 30.

Video Quality(string)

The quality preset of the generated video. Allowed values: low, medium, high, maximum.

FPS(number)

160

Frames per second of the generated video. Range: 1 to 60.

Match Audio Length(boolean)

When enabled, derives the number of frames from the audio duration and frames_per_second. When disabled, uses num_frames.

Image Strength(number)

Conditioning strength for the optional first frame. 1.0 keeps the image more strictly; lower values give the model more freedom. Range: 0 to 1.

Video Write Mode(string)

The write mode of the generated video. Allowed values: fast, balanced, small.

Number of Frames(integer)

9481

The number of frames to generate. Range: 9 to 481.

Seed(integer)

Random seed for reproducibility. If None, a random seed is chosen.

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDlightricks/ltx-2.3-quality/audio-to-video

Input Schema

14 parameters · 2 required · 12 optional

Parameter	Type	Required	Description
`image`	string	Required	Optional URL of an image to use as the first frame. When omitted, generation runs from text and audio only.
`prompt`	string	Required	The prompt to guide the audio-driven video generation.
`seed`	integer	Optional	Random seed for reproducibility. If None, a random seed is chosen.
`audio`	string	Optional	The URL of the audio track that drives generation.
`num_frames`	integer	Optional	The number of frames to generate. · Min: 9 · Max: 481 · Default: 121
`resolution`	string	Optional	Final output size. 'auto' matches the input image aspect ratio when image_url is provided; otherwise it uses a landscape fallback. · Options: auto, square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9 · Default: "auto" autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
`video_quality`	string	Optional	The quality preset of the generated video. · Options: low, medium, high, maximum · Default: "high" lowmediumhighmaximum
`generate_audio`	boolean	Optional	Whether to include audio in the returned video. When disabled, the final MP4 is returned without an audio track. · Default: true
`guidance_scale`	number	Optional	Classifier-free guidance scale. The default is tuned for fast, high-quality generation. · Min: 1 · Max: 20 · Default: 1
`image_strength`	number	Optional	Conditioning strength for the optional first frame. 1.0 keeps the image more strictly; lower values give the model more freedom. · Min: 0 · Max: 1 · Default: 0.7
`video_write_mode`	string	Optional	The write mode of the generated video. · Options: fast, balanced, small · Default: "balanced" fastbalancedsmall
`frames_per_second`	number	Optional	Frames per second of the generated video. · Min: 1 · Max: 60 · Default: 24
`match_audio_length`	boolean	Optional	When enabled, derives the number of frames from the audio duration and frames_per_second. When disabled, uses num_frames. · Default: true
`num_inference_steps`	integer	Optional	Number of inference steps. Defaults to 15 and can be increased up to 30. · Min: 8 · Max: 30 · Default: 15

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

Submit — POST to /v1/run, receive an id
Poll — GET /v1/run/{id} until status is completed, failed, or timeout
Retrieve — Read outputs from the completed response

Code Examples

Ready-to-run snippets

# Step 1: Submit
curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "lightricks/ltx-2.3-quality/audio-to-video",
  "audio": "https://storage.googleapis.com/falserverless/example_inputs/ltx-2-a2v-input-audio.mp3",
  "image": "https://storage.googleapis.com/falserverless/example_inputs/ltx-2-a2v-input-image.png",
  "prompt": "A person facing the camera sings with expressive natural motion, cinematic portrait lighting, realistic facial performance.",
  "num_frames": 121,
  "resolution": "auto",
  "video_quality": "high",
  "generate_audio": true,
  "guidance_scale": 1,
  "image_strength": 0.7,
  "video_write_mode": "balanced",
  "frames_per_second": 24,
  "match_audio_length": true,
  "num_inference_steps": 15
}'

# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
  -H "Authorization: Bearer YOUR_API_KEY"

← Back to Ltx 2.3 Quality

API README

PRICED DRAFT — MANUAL REVIEW REQUIRED exact_model_mode: lightricks/ltx-2.3-quality/audio-to-video original_unit: Your request will cost $0.0024075 per megapixel of generated video data (width × height × frames), rounded up. For example, if you generate a video that is 121 frames long at 1280 × 720, your total generated video is ≈112 MP, and your request will cost $0.270. method: generated-video megapixel price with image-size preset pixels result_base_price: 0.26964 result_price_formula: Math.ceil((((params.resolution ?? "landscape_16_9") == "square_hd" ? 1048576 : (params.resolution ?? "landscape_16_9") == "square" ? 262144 : ((params.resolution ?? "landscape_16_9") == "portrait_4_3" || (params.resolution ?? "landscape_16_9") == "landscape_4_3") ? 786432 : ((params.resolution ?? "landscape_16_9") == "portrait_16_9" || (params.resolution ?? "landscape_16_9") == "landscape_16_9") ? 921600 : 921600) * (params.num_frames ?? 121)) / 1000000) * 0.0024075 review_status: pending; model remains disabled checked_at: 2026-08-16