API reference · Lightricks

lightricks/ltx-video-13b-dev

Integrate this model through SandBase's unified API, with production-ready schemas and examples.

VIDEOAsyncOpen model

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDlightricks/ltx-video-13b-dev

Input Schema

15 parameters · 1 required · 14 optional

Parameter	Type	Required	Description
`prompt`	string	Required	Text prompt to guide generation
`seed`	integer	Optional	Random seed for generation
`loras`	object[]	Optional	LoRA weights to use for generation · Default: []
`frame_rate`	integer	Optional	The frame rate of the video. · Min: 1 · Max: 60 · Default: 24
`num_frames`	integer	Optional	The number of frames in the video. · Min: 9 · Max: 1441 · Default: 121
`resolution`	string	Optional	Resolution of the generated video. · Options: 480p, 720p · Default: "720p" 480p720p
`aspect_ratio`	string	Optional	The aspect ratio of the generated image. · Options: 21:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16 21:916:93:24:35:41:14:53:42:39:16
`expand_prompt`	boolean	Optional	Whether to expand the prompt using a language model. · Default: false
`reverse_video`	boolean	Optional	Whether to reverse the video. · Default: false
`enable_detail_pass`	boolean	Optional	Whether to use a detail pass. If True, the model will perform a second pass to refine the video and enhance details. This incurs a 2.0x cost multiplier on the base price. · Default: false
`temporal_adain_factor`	number	Optional	The factor for adaptive instance normalization (AdaIN) applied to generated video chunks after the first. This can help deal with a gradual increase in saturation/contrast in the generated video by normalizing the color distribution across the video. A high value will ensure the color distribution is more consistent across the video, while a low value will allow for more variation in color distribution. · Min: 0 · Max: 1 · Default: 0.5
`tone_map_compression_ratio`	number	Optional	The compression ratio for tone mapping. This is used to compress the dynamic range of the video to improve visual quality. A value of 0.0 means no compression, while a value of 1.0 means maximum compression. · Min: 0 · Max: 1 · Default: 0
`first_pass_num_inference_steps`	integer	Optional	Number of inference steps during the first pass. · Min: 2 · Max: 50 · Default: 30
`second_pass_skip_initial_steps`	integer	Optional	The number of inference steps to skip in the initial steps of the second pass. By skipping some steps at the beginning, the second pass can focus on smaller details instead of larger changes. · Min: 0 · Max: 49 · Default: 17
`second_pass_num_inference_steps`	integer	Optional	Number of inference steps during the second pass. · Min: 2 · Max: 50 · Default: 30

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-video-13b-dev",
  "loras": [],
  "prompt": "A cinematic fast-tracking shot follows a vintage, teal camper van as it descends a winding mountain trail. The van, slightly weathered but well-maintained, is the central focus, its retro design emphasized by the motion blur. Medium shot reveals the dusty, ochre trail, edged with vibrant green pine trees. Close-up on the van's tires shows the gravel spraying, highlighting the speed and rugged terrain. Sunlight filters through the trees, casting dappled shadows on the van and the trail. The background is a hazy, majestic mountain range bathed in warm, golden light. The overall mood is adventurous and exhilarating. High resolution 4k movie scene.",
  "frame_rate": 24,
  "num_frames": 121,
  "resolution": "720p",
  "expand_prompt": false,
  "reverse_video": false,
  "enable_detail_pass": false,
  "temporal_adain_factor": 0.5,
  "tone_map_compression_ratio": 0,
  "first_pass_num_inference_steps": 30,
  "second_pass_skip_initial_steps": 17,
  "second_pass_num_inference_steps": 30
}'

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

← Back to LTX Video-0.9.7 13B