API reference · Lightricks

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

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-2-19b/image-to-video/lora
01

Input Schema

11 parameters · 2 required · 9 optional

ParameterTypeRequiredDescription
imagestringRequiredThe URL of the image to generate the video from.
promptstringRequiredThe prompt used for the generation.
seedintegerOptionalThe seed for the random number generator.
lorasarrayOptional
end_imagestringOptionalThe URL of the image to use as the end of the video.
generate_audiobooleanOptionalWhether to generate audio for the video. · Default: true
guidance_scalenumberOptionalMin: 1 · Max: 10 · Default: 3
image_strengthnumberOptionalThe strength of the image to use for the video generation. · Min: 0 · Max: 1 · Default: 1
end_image_strengthnumberOptionalThe strength of the end image to use for the video generation. · Min: 0 · Max: 1 · Default: 1
num_inference_stepsintegerOptionalMin: 8 · Max: 50 · Default: 40
interpolation_directionstringOptionalThe direction to interpolate the image sequence in. 'Forward' goes from the start image to the end image, 'Backward' goes from the end image to the start image. · Options: forward, backward · Default: "forward"
forwardbackward
02

Output Schema

FieldTypeDescription
idstringUnique identifier for the generation task
statusstringTask status: pending, running, completed, failed, timeout
modelstringModel used for the generation
outputsarrayArray of output items
outputs[].urlstringURL of the generated artifact
outputs[].content_typestringMIME type (e.g. image/png, video/mp4)
errorobject | nullError details if failed, null on success
error.typestringMachine-readable error type code
error.messagestringHuman-readable error description

Async Workflow

This model uses asynchronous execution. Submit a request and poll for the result.

  1. Submit — POST to /v1/run, receive an id
  2. Poll — GET /v1/run/{id} until status is completed, failed, or timeout
  3. Retrieve — Read outputs from the completed response
03

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/image-to-video/lora",
  "image": "https://static.sandbase.ai/examples/lightricks/ltx-2-19b/image-to-video/lora/input_image_0.jpg",
  "prompt": "A woman stands still amid a busy neon-lit street at night. The camera slowly dollies in toward her face as people blur past, their motion emphasizing her calm presence. City lights flicker and reflections shift across her denim jacket.",
  "generate_audio": true,
  "guidance_scale": 3,
  "image_strength": 1,
  "end_image_strength": 1,
  "num_inference_steps": 40,
  "interpolation_direction": "forward"
}'

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