v1

latestOpenAPI 3.1.02026-08-04143345.6 KB

asyncVideoGeneration

Generate video from audio

Generate a video driven by an audio track. Supply dialogue, music, or ambient sound and the model produces visuals synchronized to the audio. Optionally condition on a reference image for visual direction.

Responds immediately with the job id and created_at timestamp. Poll GET /v2/audio-to-video/{id} until the status is completed, then download from result.video_url.

Billed per second of input audio. See Pricing.

post/v2/audio-to-video

Headers

Authorizationstring required

API key authentication

Request body

audio_uristring required

Audio file to be used as the soundtrack for the video. Duration must be between 2 and 20 seconds. See Input Formats for supported formats and size limits.

image_uristring

Input image to be used as the first frame of the video. Required if prompt is not provided. See Input Formats for supported formats and size limits.

promptstring

Text description of how the video should be generated. Required if image_uri is not provided. Can be empty string when image_uri is provided. If image_uri is provided, this describes how the image should be animated. If no image_uri is provided, this describes the video content.

resolution'1920x1080' | '1080x1920'

The resolution of the generated video in WIDTHxHEIGHT format. When omitted, the resolution is automatically determined based on the input image orientation — portrait images produce 1080x1920 video, landscape images produce 1920x1080 video. If no image is provided, defaults to 1920x1080.

guidance_scalenumber double

Optional guidance scale (also known as CFG) for video generation. Higher values make the output more closely follow the prompt but may reduce quality. Defaults to 5 for text-to-video, or 9 when providing an image.

model'ltx-2-pro' | 'ltx-2-3-pro'

Model to use for video generation.

Deprecated: ltx-2-pro is deprecated. See the LTX-2 Deprecation Notice.

Response

Job submitted successfully

idstring required

Unique job identifier. Use this to poll for status.

created_atstring date-time required

ISO 8601 timestamp of when the job was created.