---
title: "Generate video from audio"
method: POST
path: "/v2/audio-to-video"
tags: ["asyncVideoGeneration"]
---

# Generate video from audio

`POST /v2/audio-to-video`

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, a last frame for interpolation, and camera motion. Output frame rate defaults to 24 fps; its length is set by the audio.

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](/pricing).

## Headers

- `Authorization` string, required

## Request body

- AudioToVideoRequest
  - `audio_uri` string, required — Audio file to be used as the soundtrack for the video. The audio sets the length of the generated video, so its duration must not exceed the maximum the selected model supports at the chosen resolution. | Model | Resolution | Maximum audio duration | | --- | --- | --- | | `ltx-2-5-fast` | 720p, 1080p | 20 seconds | | `ltx-2-5-fast` | 1440p, 4K | 10 seconds | | `ltx-2-5-pro` | 720p, 1080p | 10 seconds | | `ltx-2-3-pro` | 720p, 1080p | 20 seconds | | `ltx-2-3-pro` | 1440p, 4K | 10 seconds | See [Input Formats](/input-formats#audio-input) for supported formats and size limits.
  - `image_uri` string — Input image to be used as the first frame of the video. Required if prompt is not provided. See [Input Formats](/input-formats#image-input) for supported formats and size limits.
  - `prompt` string — 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` string — 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. Supported resolutions depend on the model — see [Supported Models](/models) for the full matrix. `ltx-2-5-fast` and `ltx-2-3-pro` support 720p through 4K; `ltx-2-5-pro` supports 720p and 1080p only.
  - `model` 'ltx-2-3-pro' | 'ltx-2-5-fast' | 'ltx-2-5-pro' — Model to use for video generation.
  - `fps` integer — Frame rate in frames per second. See [Supported Models](/models) for available FPS per model and resolution.
  - `last_frame_uri` string — Image to be used as the last frame of the video. Requires `image_uri`. When provided, the video interpolates between the first and last frame. See [Input Formats](/input-formats#image-input) for supported formats and size limits.
  - `camera_motion` 'dolly_in' | 'dolly_out' | 'dolly_left' | 'dolly_right' | 'jib_up' | 'jib_down' | 'static' | 'focus_shift' — Apply camera motion effects to the generated video.

## Response `202`

Job submitted successfully

- V2JobCreatedResponse — Response returned when a V2 async job is successfully submitted.
  - `id` string, required — Unique job identifier. Use this to poll for status.
  - `created_at` string, date-time, required — ISO 8601 timestamp of when the job was created.

## Other responses

- `400` — The request is invalid or malformed
- `401` — Authentication failed
- `402` — Insufficient credits
- `422` — Content rejected by safety filters
- `429` — Concurrency or queue limit exceeded
- `500` — An unexpected error occurred
- `503` — Service temporarily unavailable

## Changes

> 5 revisions in range; 3 could not be searched.

- **2026-08-12** `652926962fae` — 2 info
  - added the new `ltx-2-5-fast` enum value to the request property `model`
  - added the new `ltx-2-5-pro` enum value to the request property `model`

[Change history](https://skmtc.dev/ltx/apis/api-reference/changes/v2/audio-to-video/post.md)

---

[API](https://skmtc.dev/ltx/apis/api-reference.md) · [All operations](https://skmtc.dev/ltx/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ltx/api-reference/revisions/6ad7c87b252c/schema)