SandBase is live — $1 in free credits on signupStart free ›
Start building
Use in agentLightricks models

Lightricks modelsvideo generation api

lightricks/ltx-2.3-22b/reference-to-video

Ltx 2.3 22b 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
The prompt to generate the video from.

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

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

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

The URL of the image to use as the end of the video.
The URL of the video to reference.
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.
Whether to generate audio for the video.
The aspect ratio of the generated video. Allowed values: 16:9, 9:16, 4:3, 3:4, 1:1.
Idle

Example output — click Run to generate your own

API README

LTX 2.3 22B Reference to Video

LTX 2.3 22B Reference to Video is a reference-guided video creation endpoint in the LTX 2.3 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 aspect ratio, generate audio 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

  • Reference clip as creative anchor. The video input supplies motion or visual identity to reference while the prompt describes the intended new result.
  • Opening-frame guidance. An optional image can fix the generated shot’s initial appearance in addition to the reference video.
  • Independent sound conditioning. An optional audio input can replace or guide the soundtrack separately from the visual reference.
  • LTX 2.3 22B reference-strength controls. video_strength, image_strength, or audio_strength tune each conditioning channel where those fields are documented. This behavior is exposed on the named 22B route. For lightricks/ltx-2.3-22b/reference-to-video, this task-specific control is documented alongside the route’s own required inputs.

Pricing

Billing unitPrice
Base request$0.001605

When to Use

ScenarioRecommendation
Choose this routeUse it when the deliverable specifically calls for reference-guided video creation, rather than a neighboring generation mode.
Prepare the sourceProvide image, video, audio in the format described by the request schema.
Direct the shotDescribe the subject, action, environment, camera movement, lighting, and temporal progression in that order.
Control continuityUse endpoint frames, reference media, strength, or audio controls when those fields are available instead of burying hard constraints in prose.
Plan deliverySet 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 reference-guided video creation, 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": "style: cinematic/realistic. A man wearing a baseball cap walks through a modern town. He holds a coffee cup.",
  "image": "https://example.com/reference.jpg",
  "aspect_ratio": "16:9",
  "generate_audio": true,
  "video": "https://static.sandbase.ai/examples/lightricks/ltx-2.3-22b/reference-to-video/output_url_0.mp4",
  "audio": "https://example.com/soundtrack.mp3"
}

Technical Specs

SpecificationValue
Model IDlightricks/ltx-2.3-22b/reference-to-video
Required inputsprompt, image
ExecutionAsynchronous generation job
Request controls7 documented fields
Outputurl, content_type

Request fields

FieldType and constraints
audiostring; Optional
imagestring; Required
videostring; Optional
promptstring; Required
end_imagestring; Optional
aspect_ratiostring; Optional; Options: 16:9, 9:16, 4:3, 3:4, 1:1; Default: "16:9"
generate_audioboolean; Optional; Default: true

Related Models

Related Models

lightricks/ltx-2.3-22b/audio-to-videoLtx 2.3 22b Audio To Video by Lightricks - advanced AI model for audio-to-video. Delivers high-quality results with fast inference, suitable for both creative and production workflows.lightricks/ltx-2.3-22b/audio-to-video/loraLtx 2.3 22b Audio To Video Lora by Lightricks - advanced AI model for audio-to-video. Delivers high-quality results with fast inference, suitable for both creative and production workflows.lightricks/ltx-2.3-22b/distilled/audio-to-video/loraLtx 2.3 22b Distilled Audio To Video by Lightricks - advanced AI model for audio-to-video. Delivers high-quality results with fast inference, suitable for both creative and production workflows.lightricks/ltx-2.3-22b/distilled/image-to-video/loraLtx 2.3 22b Distilled Lora is Lightricks's image-to-video AI model. Bring static images to life with fluid animation, consistent character motion, and professional-grade video output.lightricks/ltx-2.3-22b/distilled/reference-video-to-video/loraLtx 2.3 22b Distilled Reference Video To Video is Lightricks's video-to-video AI model. Transform, enhance, and edit video content using text prompts - from style changes to object manipulation and scene modification.lightricks/ltx-2.3-22b/distilled/text-to-video/loraLtx 2.3 22b Distilled Lora by Lightricks - generate cinematic videos from text descriptions with AI. Create high-quality video content with natural motion, camera control, and optional audio generation.lightricks/ltx-2.3-22b/distilled/video-to-video/loraLtx 2.3 22b Distilled Video To Video is Lightricks's video-to-video AI model. Transform, enhance, and edit video content using text prompts - from style changes to object manipulation and scene modification.lightricks/ltx-2.3-22b/extendLtx 2.3 22b Extend 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.