lightricks/ltx-2-19b/video-to-video

Name: LTX-2 19B
Author: Lightricks

Ltx 2 19b Video To Video by Lightricks - AI-powered video editing and transformation. Apply style transfer, motion control, lip-sync, and visual effects to existing videos with natural language instructions.

Input

Prompt(string)

The prompt to generate the video from.

Image URL or upload(string)

Upload

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

An optional URL of an image to use as the first frame of the video.

This field is required.

Image URL or upload(string)

Upload

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

The URL of the image to use as the end of the video.

Video URL(string)

The URL of the video to generate the video from.

Audio URL(string)

An optional URL of an audio to use as the audio for the video. If not provided, any audio present in the input video will be used.

Generate Audio(boolean)

Whether to generate audio for the video.

Guidance Scale(number)

110

The guidance scale to use. Range: 1 to 10.

Number of Inference Steps(integer)

850

The number of inference steps to use. Range: 8 to 50.

Match Input FPS(boolean)

When true, match the output FPS to the input video's FPS instead of using the default target FPS.

Preprocessor(string)

The preprocessor to use for the video. When a preprocessor is used and `ic_lora_type` is set to `match_preprocessor`, the IC-LoRA will be loaded based on the preprocessor type. Allowed values: depth, canny, pose, none.

Number of Frames(integer)

9481

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

Video Size(string)

The size of the generated video. Allowed values: auto, square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9.

Camera LoRA Scale(number)

The scale of the camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the model to move the camera. Range: 0 to 1.

Video Strength(number)

Video conditioning strength. Lower values represent more freedom given to the model to change the video content. Range: 0 to 1.

Video Write Mode(string)

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

Audio Strength(number)

Audio conditioning strength. Lower values represent more freedom given to the model to change the audio content. Range: 0 to 1.

Camera LoRA(string)

The camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the model to move the camera. Allowed values: dolly_in, dolly_out, dolly_left, dolly_right, jib_up, jib_down, static, none.

Image Strength(number)

The strength of the image to use for the video generation. Range: 0 to 1.

FPS(number)

160

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

Match Video Length(boolean)

When enabled, the number of frames will be calculated based on the video duration and FPS. When disabled, use the specified num_frames.

Video Quality(string)

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

Video Output Type(string)

The output type of the generated video. Allowed values: X264 (.mp4), VP9 (.webm), PRORES4444 (.mov), GIF (.gif).

End Image Strength(number)

The strength of the end image to use for the video generation. Range: 0 to 1.

IC-LoRA(string)

The type of IC-LoRA to load. In-Context LoRA weights are used to condition the video based on edge, depth, or pose videos. Only change this from `match_preprocessor` if your videos are already preprocessed (or you are using the detailer.) Allowed values: match_preprocessor, canny, depth, pose, detailer, none.

Use Multi-Scale(boolean)

Whether to use multi-scale generation. If True, the model will generate the video at a smaller scale first, then use the smaller video to guide the generation of a video at or above your requested size. This results in better coherence and details.

IC-LoRA Scale(number)

The scale of the IC-LoRA to use. This allows you to control the strength of the IC-LoRA. Range: 0 to 1.

Seed(integer)

The seed for the random number generator.

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-19b/video-to-video

Input Schema

27 parameters · 2 required · 25 optional

Parameter	Type	Required	Description
`image`	string	Required	An optional URL of an image to use as the first frame of the video.
`prompt`	string	Required	The prompt to generate the video from.
`fps`	number	Optional	The frames per second of the generated video. · Min: 1 · Max: 60 · Default: 25
`seed`	integer	Optional	The seed for the random number generator.
`audio`	string	Optional	An optional URL of an audio to use as the audio for the video. If not provided, any audio present in the input video will be used.
`video`	string	Optional	The URL of the video to generate the video from.
`ic_lora`	string	Optional	The type of IC-LoRA to load. In-Context LoRA weights are used to condition the video based on edge, depth, or pose videos. Only change this from `match_preprocessor` if your videos are already preprocessed (or you are using the detailer.) · Options: match_preprocessor, canny, depth, pose, detailer, none · Default: "match_preprocessor" match_preprocessorcannydepthposedetailernone
`end_image`	string	Optional	The URL of the image to use as the end of the video.
`num_frames`	integer	Optional	The number of frames to generate. · Min: 9 · Max: 481 · Default: 121
`video_size`	string	Optional	The size of the generated video. · 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
`camera_lora`	string	Optional	The camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the model to move the camera. · Options: dolly_in, dolly_out, dolly_left, dolly_right, jib_up, jib_down, static, none · Default: "none" dolly_indolly_outdolly_leftdolly_rightjib_upjib_downstaticnone
`preprocessor`	string	Optional	The preprocessor to use for the video. When a preprocessor is used and `ic_lora_type` is set to `match_preprocessor`, the IC-LoRA will be loaded based on the preprocessor type. · Options: depth, canny, pose, none · Default: "none" depthcannyposenone
`ic_lora_scale`	number	Optional	The scale of the IC-LoRA to use. This allows you to control the strength of the IC-LoRA. · Min: 0 · Max: 1 · Default: 1
`video_quality`	string	Optional	The quality of the generated video. · Options: low, medium, high, maximum · Default: "high" lowmediumhighmaximum
`audio_strength`	number	Optional	Audio conditioning strength. Lower values represent more freedom given to the model to change the audio content. · Min: 0 · Max: 1 · Default: 1
`generate_audio`	boolean	Optional	Whether to generate audio for the video. · Default: true
`guidance_scale`	number	Optional	The guidance scale to use. · Min: 1 · Max: 10 · Default: 3
`image_strength`	number	Optional	The strength of the image to use for the video generation. · Min: 0 · Max: 1 · Default: 1
`use_multiscale`	boolean	Optional	Whether to use multi-scale generation. If True, the model will generate the video at a smaller scale first, then use the smaller video to guide the generation of a video at or above your requested size. This results in better coherence and details. · Default: true
`video_strength`	number	Optional	Video conditioning strength. Lower values represent more freedom given to the model to change the video content. · Min: 0 · Max: 1 · Default: 1
`match_input_fps`	boolean	Optional	When true, match the output FPS to the input video's FPS instead of using the default target FPS. · Default: true
`video_write_mode`	string	Optional	The write mode of the generated video. · Options: fast, balanced, small · Default: "balanced" fastbalancedsmall
`camera_lora_scale`	number	Optional	The scale of the camera LoRA to use. This allows you to control the camera movement of the generated video more accurately than just prompting the model to move the camera. · Min: 0 · Max: 1 · Default: 1
`video_output_type`	string	Optional	The output type of the generated video. · Options: X264 (.mp4), VP9 (.webm), PRORES4444 (.mov), GIF (.gif) · Default: "X264 (.mp4)" X264 (.mp4)VP9 (.webm)PRORES4444 (.mov)GIF (.gif)
`end_image_strength`	number	Optional	The strength of the end image to use for the video generation. · Min: 0 · Max: 1 · Default: 1
`match_video_length`	boolean	Optional	When enabled, the number of frames will be calculated based on the video duration and FPS. When disabled, use the specified num_frames. · Default: true
`num_inference_steps`	integer	Optional	The number of inference steps to use. · Min: 8 · Max: 50 · Default: 40

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-19b/video-to-video",
  "fps": 25,
  "video": "https://static.sandbase.ai/examples/lightricks/ltx-2-19b/video-to-video/input_video_0.mp4",
  "prompt": "black-and-white video, a cowboy walks through a dusty town, film grain",
  "ic_lora": "match_preprocessor",
  "num_frames": 121,
  "video_size": "auto",
  "camera_lora": "none",
  "preprocessor": "none",
  "ic_lora_scale": 1,
  "video_quality": "high",
  "audio_strength": 1,
  "generate_audio": true,
  "guidance_scale": 3,
  "image_strength": 1,
  "use_multiscale": true,
  "video_strength": 1,
  "match_input_fps": true,
  "video_write_mode": "balanced",
  "camera_lora_scale": 1,
  "video_output_type": "X264 (.mp4)",
  "end_image_strength": 1,
  "match_video_length": true,
  "num_inference_steps": 40
}'

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

← Back to LTX-2 19B

API README

LTX-2 19B

LTX-2 19B is a video transformation endpoint in the LTX 2 19B family. It is built for creators who need to turn a concrete creative brief into a controlled visual sequence: the request establishes the source material, the intended subject behavior, the camera language, and the atmosphere of the finished shot. The standard route keeps that workflow explicit instead of hiding its input assumptions behind a generic video-generation label.

In practice, this route accepts image, video, audio, end image as creative context and exposes num frames, video size, generate audio, image strength, video strength, camera lora for delivery planning. That makes it suitable for shot-based pipelines where teams must preserve a source, direct a transformation, or control the final format without losing sight of the model's central task. Write prompts as a compact shot plan—subject, action, setting, camera, light, and timing—then use the structured fields for constraints that should remain deterministic across iterations.

Highlights

Clip-to-clip transformation. Reworks an input video's appearance or motion under prompt control rather than generating from an empty timeline.
Synchronized audio path. Audio conditioning or generation is available in the same request, helping sound and picture share one creative plan.
Endpoint composition. An optional end frame can anchor where the shot lands, giving transitions a deliberate visual destination.
Conditioning strength control. Strength parameters tune how closely the result follows its source versus how freely it changes.

Pricing

Billing unit	Price
Base request	`$0.001800`

When to Use

Scenario	Recommendation
Choose this route	Use it when the deliverable specifically calls for video transformation, rather than a neighboring generation mode.
Prepare the source	Provide image, video, audio in the format described by the request schema.
Direct the shot	Describe the subject, action, environment, camera movement, lighting, and temporal progression in that order.
Control continuity	Use endpoint frames, reference media, strength, or audio controls when those fields are available instead of burying hard constraints in prose.
Plan delivery	Set duration, frame count, resolution, and aspect ratio explicitly when the schema exposes them, then compare iterations with a stable seed where supported.

Prompt Guide

For video transformation, describe one coherent shot rather than a list of visual keywords. Put the main subject and action first, follow with location and staging, then add camera movement, lens or framing, lighting, mood, and any timed change. Keep URLs and hard delivery choices in their dedicated fields.

{
  "prompt": "black-and-white video, a cowboy walks through a dusty town, film grain",
  "image": "https://example.com/reference.jpg",
  "generate_audio": true,
  "video": "https://static.sandbase.ai/examples/lightricks/ltx-2-19b/video-to-video/input_video_0.mp4",
  "audio": "https://example.com/soundtrack.mp3",
  "end_image": "https://example.com/reference.jpg"
}

Technical Specs

Specification	Value
Model ID	`lightricks/ltx-2-19b/video-to-video`
Required inputs	`prompt`, `image`
Execution	Asynchronous generation job
Request controls	27 documented fields
Output	`url`, `content_type`

Request fields

Field	Type and constraints
`fps`	number; Optional; Range: 1–60; Default: 25
`seed`	integer; Optional
`audio`	string; Optional
`image`	string; Required
`video`	string; Optional
`prompt`	string; Required
`ic_lora`	string; Optional; Options: match_preprocessor, canny, depth, pose, detailer, none; Default: "match_preprocessor"
`end_image`	string; Optional
`num_frames`	integer; Optional; Range: 9–481; Default: 121
`video_size`	string; Optional; Options: auto, square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9; Default: "auto"
`camera_lora`	string; Optional; Options: dolly_in, dolly_out, dolly_left, dolly_right, jib_up, jib_down, static, none; Default: "none"
`preprocessor`	string; Optional; Options: depth, canny, pose, none; Default: "none"
`ic_lora_scale`	number; Optional; Range: 0–1; Default: 1
`video_quality`	string; Optional; Options: low, medium, high, maximum; Default: "high"
`audio_strength`	number; Optional; Range: 0–1; Default: 1
`generate_audio`	boolean; Optional; Default: true
`guidance_scale`	number; Optional; Range: 1–10; Default: 3
`image_strength`	number; Optional; Range: 0–1; Default: 1
`use_multiscale`	boolean; Optional; Default: true
`video_strength`	number; Optional; Range: 0–1; Default: 1
`match_input_fps`	boolean; Optional; Default: true
`video_write_mode`	string; Optional; Options: fast, balanced, small; Default: "balanced"
`camera_lora_scale`	number; Optional; Range: 0–1; Default: 1
`video_output_type`	string; Optional; Options: X264 (.mp4), VP9 (.webm), PRORES4444 (.mov), GIF (.gif); Default: "X264 (.mp4)"
`end_image_strength`	number; Optional; Range: 0–1; Default: 1
`match_video_length`	boolean; Optional; Default: true
`num_inference_steps`	integer; Optional; Range: 8–50; Default: 40