API ReferenceVideo Generation

Generate video from image

Transform a static image into a dynamic video. Provide an image and text prompt to guide the AI generation process.

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.

Allowed values:
durationintegerRequired

Video duration in seconds. See Supported Models for available durations per model.

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.

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](/input-formats#image-input) for supported formats and size limits. > Note: Only supported by `ltx-2-3` models (`ltx-2-3-fast`, `ltx-2-3-pro`).
camera_motionenumOptional
Apply camera motion effects to the generated video.
generate_audiobooleanOptionalDefaults to trueBeta

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.

Response headers

x-request-idstring
Unique request identifier for tracking and debugging
Content-Typestring
The MIME type of the video file
Content-Lengthinteger
The size of the video file in bytes

Response

Video generated successfully

Errors

400
Bad Request Error
401
Unauthorized Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
503
Service Unavailable Error
504
Gateway Timeout Error