API ReferenceAsync Video Generation

Generate video from image

Animate a still image with realistic motion, depth, and audio. Provide a reference image plus a prompt describing the desired motion. The output preserves the visual identity of the source image. Responds immediately with the job `id` and `created_at` timestamp. Poll `GET /v2/image-to-video/{id}` until the status is `completed`, then download from `result.video_url`. Billed per second of generated video. See [Pricing](/pricing).

Authentication

AuthorizationBearer
API key authentication

Request

This endpoint expects an object.
image_uristringRequired

Image to be used as the first frame of the video. See Input Formats for supported formats and size limits.

promptstringRequired<=5000 characters
Text description of how the image should be animated, can relate to the details in the image
modelenumRequired

Model to use for generation. See Supported Models for details.

Deprecated: ltx-2-fast and ltx-2-pro are deprecated. See the LTX-2 Deprecation Notice.

durationinteger or nullRequired

Video duration in seconds. See Supported Models for available durations per model. Pass null to let ltx-2-5-fast or ltx-2-5-pro choose the length from your prompt — see Automatic duration. Cannot be combined with last_frame_uri.

resolutionstringRequired

Output video resolution. See Supported Models for available resolutions per model.

fpsintegerOptionalDefaults to 24

Frame rate in frames per second. See Supported Models for available FPS per model and resolution.

generate_audiobooleanOptionalDefaults to true

Generate audio for the video. When true, the generated video will include AI-generated audio matching the scene. When false, only silent video is generated.

last_frame_uristringOptional

Image to be used as the last frame of the video. When provided, the video will interpolate between the first frame (image_uri) and this last frame. See Input Formats for supported formats and size limits.

Note: Not supported by the deprecated ltx-2-fast and ltx-2-pro models.

camera_motionenumOptional
Apply camera motion effects to the generated video.

Response

Job submitted successfully
idstring
Unique job identifier. Use this to poll for status.
created_atdatetime
ISO 8601 timestamp of when the job was created.

Errors

400
Bad Request Error
401
Unauthorized Error
402
Payment Required Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error