lightricks/ltx-2.3-quality/image-to-video
Ltx 2.3 Quality by Lightricks - animate still images into dynamic videos with AI. Transform photos into cinematic clips with natural motion, camera movement, and optional audio generation.
Example output — click Run to generate your own
Send your first request
OpenAI-compatible endpoint with unified authentication and usage tracking.
https://api.sandbase.ai/v1/runlightricks/ltx-2.3-quality/image-to-videoInput Schema
12 parameters · 2 required · 10 optional
| Parameter | Type | Required | Description |
|---|---|---|---|
image | string | Required | The URL of the starting image. |
prompt | string | Required | The prompt to guide the video generation. |
seed | integer | Optional | Random seed for reproducibility. If None, a random seed is chosen. |
num_frames | integer | Optional | The number of frames to generate. · Min: 9 · Max: 481 · Default: 121 |
resolution | string | Optional | The size of the generated video. 'auto' derives the size from the input image aspect ratio. · 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 |
video_quality | string | Optional | The quality preset of the generated video. · Options: low, medium, high, maximum · Default: "high" lowmediumhighmaximum |
generate_audio | boolean | Optional | Whether to include audio in the returned video. When disabled, the final MP4 is returned without an audio track. · Default: true |
guidance_scale | number | Optional | Classifier-free guidance scale. The default is tuned for fast, high-quality generation. · Min: 1 · Max: 20 · Default: 1 |
image_strength | number | Optional | Conditioning strength on the start image. 1.0 = exact first-frame match, lower = more freedom for the model. · Min: 0 · Max: 1 · Default: 0.7 |
video_write_mode | string | Optional | The write mode of the generated video. · Options: fast, balanced, small · Default: "balanced" fastbalancedsmall |
frames_per_second | number | Optional | Frames per second of the generated video. · Min: 1 · Max: 60 · Default: 24 |
num_inference_steps | integer | Optional | Number of inference steps. Defaults to 15 and can be increased up to 30. · Min: 8 · Max: 30 · Default: 15 |
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, ortimeout - Retrieve — Read
outputsfrom 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.3-quality/image-to-video",
"image": "https://storage.googleapis.com/falserverless/example_inputs/ltxv-2-i2v-input.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.",
"num_frames": 121,
"resolution": "auto",
"video_quality": "high",
"generate_audio": true,
"guidance_scale": 1,
"image_strength": 0.7,
"video_write_mode": "balanced",
"frames_per_second": 24,
"num_inference_steps": 15
}'
# Step 2: Poll result (replace <id>)
curl https://api.sandbase.ai/v1/run/<id> \
-H "Authorization: Bearer YOUR_API_KEY"API README
PRICED DRAFT — MANUAL REVIEW REQUIRED exact_model_mode: lightricks/ltx-2.3-quality/image-to-video original_unit: Your request will cost $0.0024075 per megapixel of generated video data (width × height × frames), rounded up. For example, if you generate a video that is 121 frames long at 1280 × 720, your total generated video is ≈112 MP, and your request will cost $0.270. method: generated-video megapixel price with image-size preset pixels result_base_price: 0.26964 result_price_formula: Math.ceil((((params.resolution ?? "landscape_16_9") == "square_hd" ? 1048576 : (params.resolution ?? "landscape_16_9") == "square" ? 262144 : ((params.resolution ?? "landscape_16_9") == "portrait_4_3" || (params.resolution ?? "landscape_16_9") == "landscape_4_3") ? 786432 : 921600) * (params.num_frames ?? 121)) / 1000000) * 0.0024075 review_status: pending; model remains disabled checked_at: 2026-08-16