LTX-2 Retake

LTX-2 Retake regenerates targeted segments inside an existing clip. Define start time and duration. Replace video, audio or both with new prompts. Preserve surrounding motion and continuity. Ideal for selective revisions, dialog tweaks, and shot refinements without full regen.

API Reference
INTEGRATE
Complete technical specification for integration
RequestResponse
Examples4
CODE
Ready-to-use code snippets for common workflows
Windblown Salt Flats Chase
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'lightricks:3@1',
positivePrompt: 'Replace the selected segment with a more dramatic continuation of the salt-flat motorcycle chase: one rider cuts sharply across the other leaving a sweeping ribbon of dust, the camera drops lower near the ground for a fast tracking angle, tires scatter crystalline grit, distant mountains shimmer in the heat haze, naturalistic cinematic motion, realistic sunlight, seamless match to the surrounding footage. Regenerate both sound and picture with roaring engines, skidding grit, rushing wind, and a brief tense near-collision feeling.',
providerSettings: {
lightricks: {
startTime: 2,
duration: 3,
mode: 'replace_audio_and_video'
}
},
inputs: {
video: 'https://assets.runware.ai/assets/inputs/dfaf49f6-a1d2-4f75-b705-7f9fc11614ef.mp4'
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "lightricks:3@1",
"positivePrompt": "Replace the selected segment with a more dramatic continuation of the salt-flat motorcycle chase: one rider cuts sharply across the other leaving a sweeping ribbon of dust, the camera drops lower near the ground for a fast tracking angle, tires scatter crystalline grit, distant mountains shimmer in the heat haze, naturalistic cinematic motion, realistic sunlight, seamless match to the surrounding footage. Regenerate both sound and picture with roaring engines, skidding grit, rushing wind, and a brief tense near-collision feeling.",
"providerSettings": {
"lightricks": {
"startTime": 2,
"duration": 3,
"mode": "replace_audio_and_video"
}
},
"inputs": {
"video": "https://assets.runware.ai/assets/inputs/dfaf49f6-a1d2-4f75-b705-7f9fc11614ef.mp4"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "videoInference",
"taskUUID": "2eb310fd-c023-46a5-a0fa-5e977ff54bce",
"model": "lightricks:3@1",
"positivePrompt": "Replace the selected segment with a more dramatic continuation of the salt-flat motorcycle chase: one rider cuts sharply across the other leaving a sweeping ribbon of dust, the camera drops lower near the ground for a fast tracking angle, tires scatter crystalline grit, distant mountains shimmer in the heat haze, naturalistic cinematic motion, realistic sunlight, seamless match to the surrounding footage. Regenerate both sound and picture with roaring engines, skidding grit, rushing wind, and a brief tense near-collision feeling.",
"providerSettings": {
"lightricks": {
"startTime": 2,
"duration": 3,
"mode": "replace_audio_and_video"
}
},
"inputs": {
"video": "https://assets.runware.ai/assets/inputs/dfaf49f6-a1d2-4f75-b705-7f9fc11614ef.mp4"
}
}
]'runware run lightricks:3@1 \
positivePrompt="Replace the selected segment with a more dramatic continuation of the salt-flat motorcycle chase: one rider cuts sharply across the other leaving a sweeping ribbon of dust, the camera drops lower near the ground for a fast tracking angle, tires scatter crystalline grit, distant mountains shimmer in the heat haze, naturalistic cinematic motion, realistic sunlight, seamless match to the surrounding footage. Regenerate both sound and picture with roaring engines, skidding grit, rushing wind, and a brief tense near-collision feeling." \
providerSettings.lightricks.startTime=2 \
providerSettings.lightricks.duration=3 \
providerSettings.lightricks.mode=replace_audio_and_video \
inputs.video=https://assets.runware.ai/assets/inputs/dfaf49f6-a1d2-4f75-b705-7f9fc11614ef.mp4{
"taskType": "videoInference",
"taskUUID": "2eb310fd-c023-46a5-a0fa-5e977ff54bce",
"model": "lightricks:3@1",
"positivePrompt": "Replace the selected segment with a more dramatic continuation of the salt-flat motorcycle chase: one rider cuts sharply across the other leaving a sweeping ribbon of dust, the camera drops lower near the ground for a fast tracking angle, tires scatter crystalline grit, distant mountains shimmer in the heat haze, naturalistic cinematic motion, realistic sunlight, seamless match to the surrounding footage. Regenerate both sound and picture with roaring engines, skidding grit, rushing wind, and a brief tense near-collision feeling.",
"providerSettings": {
"lightricks": {
"startTime": 2,
"duration": 3,
"mode": "replace_audio_and_video"
}
},
"inputs": {
"video": "https://assets.runware.ai/assets/inputs/dfaf49f6-a1d2-4f75-b705-7f9fc11614ef.mp4"
}
}{
"taskType": "videoInference",
"taskUUID": "2eb310fd-c023-46a5-a0fa-5e977ff54bce",
"videoUUID": "eb3d2591-8f26-4c24-9b6b-cb72d1f8d84c",
"videoURL": "https://vm.runware.ai/video/os/a04d20/ws/5/vi/eb3d2591-8f26-4c24-9b6b-cb72d1f8d84c.mp4",
"cost": 0.605
}Fogbound Viaduct Train Crossing
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'lightricks:3@1',
positivePrompt: 'For the selected segment, transform the outside view into a surreal yet believable encounter: a giant manta-shaped wind craft made of ribbed canvas and polished brass glides alongside the train at close distance, its wings flexing in the mist, droplets trailing from the frame, soft amber guide lamps glowing under its body, swirling fog displaced by its passage, realistic motion parallax from the train window, cinematic atmosphere, seamless continuity with the original shot, matching camera angle and movement; regenerate sound to include deep fabric creaks, gusting air, resonant cable hum, and a brief hush from awestruck passengers while keeping the train ambience coherent.',
providerSettings: {
lightricks: {
startTime: 2,
duration: 3,
mode: 'replace_audio_and_video'
}
},
inputs: {
video: 'https://assets.runware.ai/assets/inputs/a3978086-ee43-4a4a-b9ee-f4462cfdd7d0.mp4'
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "lightricks:3@1",
"positivePrompt": "For the selected segment, transform the outside view into a surreal yet believable encounter: a giant manta-shaped wind craft made of ribbed canvas and polished brass glides alongside the train at close distance, its wings flexing in the mist, droplets trailing from the frame, soft amber guide lamps glowing under its body, swirling fog displaced by its passage, realistic motion parallax from the train window, cinematic atmosphere, seamless continuity with the original shot, matching camera angle and movement; regenerate sound to include deep fabric creaks, gusting air, resonant cable hum, and a brief hush from awestruck passengers while keeping the train ambience coherent.",
"providerSettings": {
"lightricks": {
"startTime": 2,
"duration": 3,
"mode": "replace_audio_and_video"
}
},
"inputs": {
"video": "https://assets.runware.ai/assets/inputs/a3978086-ee43-4a4a-b9ee-f4462cfdd7d0.mp4"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "videoInference",
"taskUUID": "b049395b-2798-47d4-a238-06ada89c143b",
"model": "lightricks:3@1",
"positivePrompt": "For the selected segment, transform the outside view into a surreal yet believable encounter: a giant manta-shaped wind craft made of ribbed canvas and polished brass glides alongside the train at close distance, its wings flexing in the mist, droplets trailing from the frame, soft amber guide lamps glowing under its body, swirling fog displaced by its passage, realistic motion parallax from the train window, cinematic atmosphere, seamless continuity with the original shot, matching camera angle and movement; regenerate sound to include deep fabric creaks, gusting air, resonant cable hum, and a brief hush from awestruck passengers while keeping the train ambience coherent.",
"providerSettings": {
"lightricks": {
"startTime": 2,
"duration": 3,
"mode": "replace_audio_and_video"
}
},
"inputs": {
"video": "https://assets.runware.ai/assets/inputs/a3978086-ee43-4a4a-b9ee-f4462cfdd7d0.mp4"
}
}
]'runware run lightricks:3@1 \
positivePrompt="For the selected segment, transform the outside view into a surreal yet believable encounter: a giant manta-shaped wind craft made of ribbed canvas and polished brass glides alongside the train at close distance, its wings flexing in the mist, droplets trailing from the frame, soft amber guide lamps glowing under its body, swirling fog displaced by its passage, realistic motion parallax from the train window, cinematic atmosphere, seamless continuity with the original shot, matching camera angle and movement; regenerate sound to include deep fabric creaks, gusting air, resonant cable hum, and a brief hush from awestruck passengers while keeping the train ambience coherent." \
providerSettings.lightricks.startTime=2 \
providerSettings.lightricks.duration=3 \
providerSettings.lightricks.mode=replace_audio_and_video \
inputs.video=https://assets.runware.ai/assets/inputs/a3978086-ee43-4a4a-b9ee-f4462cfdd7d0.mp4{
"taskType": "videoInference",
"taskUUID": "b049395b-2798-47d4-a238-06ada89c143b",
"model": "lightricks:3@1",
"positivePrompt": "For the selected segment, transform the outside view into a surreal yet believable encounter: a giant manta-shaped wind craft made of ribbed canvas and polished brass glides alongside the train at close distance, its wings flexing in the mist, droplets trailing from the frame, soft amber guide lamps glowing under its body, swirling fog displaced by its passage, realistic motion parallax from the train window, cinematic atmosphere, seamless continuity with the original shot, matching camera angle and movement; regenerate sound to include deep fabric creaks, gusting air, resonant cable hum, and a brief hush from awestruck passengers while keeping the train ambience coherent.",
"providerSettings": {
"lightricks": {
"startTime": 2,
"duration": 3,
"mode": "replace_audio_and_video"
}
},
"inputs": {
"video": "https://assets.runware.ai/assets/inputs/a3978086-ee43-4a4a-b9ee-f4462cfdd7d0.mp4"
}
}{
"taskType": "videoInference",
"taskUUID": "b049395b-2798-47d4-a238-06ada89c143b",
"videoUUID": "aa18d70a-418e-4789-8870-a160df40c151",
"videoURL": "https://vm.runware.ai/video/os/a05d22/ws/5/vi/aa18d70a-418e-4789-8870-a160df40c151.mp4",
"cost": 0.605
}Subterranean Crystal Tram Arrival
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'lightricks:3@1',
positivePrompt: 'Transform the selected segment into a majestic underground transit stop carved through towering quartz and copper-veined stone, with a sleek glass-sided tram gliding in on polished tracks. Shimmering crystals embedded in the cavern walls cast soft prismatic highlights across the platform. A few travelers in weathered expedition coats wait calmly with satchels and instrument cases. Fine dust motes drift in the air, subtle reflections ripple across the tram windows, and the arrival soundscape becomes a resonant metallic hum with echoing rail friction and distant cavern ambience. Keep camera movement, timing, and scene continuity natural with the surrounding clip.',
providerSettings: {
lightricks: {
startTime: 2,
duration: 3,
mode: 'replace_audio_and_video'
}
},
inputs: {
video: 'https://assets.runware.ai/assets/inputs/8645e38e-d263-4976-a5a0-344f1da81cab.mp4'
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "lightricks:3@1",
"positivePrompt": "Transform the selected segment into a majestic underground transit stop carved through towering quartz and copper-veined stone, with a sleek glass-sided tram gliding in on polished tracks. Shimmering crystals embedded in the cavern walls cast soft prismatic highlights across the platform. A few travelers in weathered expedition coats wait calmly with satchels and instrument cases. Fine dust motes drift in the air, subtle reflections ripple across the tram windows, and the arrival soundscape becomes a resonant metallic hum with echoing rail friction and distant cavern ambience. Keep camera movement, timing, and scene continuity natural with the surrounding clip.",
"providerSettings": {
"lightricks": {
"startTime": 2,
"duration": 3,
"mode": "replace_audio_and_video"
}
},
"inputs": {
"video": "https://assets.runware.ai/assets/inputs/8645e38e-d263-4976-a5a0-344f1da81cab.mp4"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "videoInference",
"taskUUID": "1cf591e2-05cd-46b6-988d-4b3b8daacdcf",
"model": "lightricks:3@1",
"positivePrompt": "Transform the selected segment into a majestic underground transit stop carved through towering quartz and copper-veined stone, with a sleek glass-sided tram gliding in on polished tracks. Shimmering crystals embedded in the cavern walls cast soft prismatic highlights across the platform. A few travelers in weathered expedition coats wait calmly with satchels and instrument cases. Fine dust motes drift in the air, subtle reflections ripple across the tram windows, and the arrival soundscape becomes a resonant metallic hum with echoing rail friction and distant cavern ambience. Keep camera movement, timing, and scene continuity natural with the surrounding clip.",
"providerSettings": {
"lightricks": {
"startTime": 2,
"duration": 3,
"mode": "replace_audio_and_video"
}
},
"inputs": {
"video": "https://assets.runware.ai/assets/inputs/8645e38e-d263-4976-a5a0-344f1da81cab.mp4"
}
}
]'runware run lightricks:3@1 \
positivePrompt="Transform the selected segment into a majestic underground transit stop carved through towering quartz and copper-veined stone, with a sleek glass-sided tram gliding in on polished tracks. Shimmering crystals embedded in the cavern walls cast soft prismatic highlights across the platform. A few travelers in weathered expedition coats wait calmly with satchels and instrument cases. Fine dust motes drift in the air, subtle reflections ripple across the tram windows, and the arrival soundscape becomes a resonant metallic hum with echoing rail friction and distant cavern ambience. Keep camera movement, timing, and scene continuity natural with the surrounding clip." \
providerSettings.lightricks.startTime=2 \
providerSettings.lightricks.duration=3 \
providerSettings.lightricks.mode=replace_audio_and_video \
inputs.video=https://assets.runware.ai/assets/inputs/8645e38e-d263-4976-a5a0-344f1da81cab.mp4{
"taskType": "videoInference",
"taskUUID": "1cf591e2-05cd-46b6-988d-4b3b8daacdcf",
"model": "lightricks:3@1",
"positivePrompt": "Transform the selected segment into a majestic underground transit stop carved through towering quartz and copper-veined stone, with a sleek glass-sided tram gliding in on polished tracks. Shimmering crystals embedded in the cavern walls cast soft prismatic highlights across the platform. A few travelers in weathered expedition coats wait calmly with satchels and instrument cases. Fine dust motes drift in the air, subtle reflections ripple across the tram windows, and the arrival soundscape becomes a resonant metallic hum with echoing rail friction and distant cavern ambience. Keep camera movement, timing, and scene continuity natural with the surrounding clip.",
"providerSettings": {
"lightricks": {
"startTime": 2,
"duration": 3,
"mode": "replace_audio_and_video"
}
},
"inputs": {
"video": "https://assets.runware.ai/assets/inputs/8645e38e-d263-4976-a5a0-344f1da81cab.mp4"
}
}{
"taskType": "videoInference",
"taskUUID": "1cf591e2-05cd-46b6-988d-4b3b8daacdcf",
"videoUUID": "94936a61-18fa-4f13-8826-254f811ca441",
"videoURL": "https://vm.runware.ai/video/os/a12d13/ws/5/vi/94936a61-18fa-4f13-8826-254f811ca441.mp4",
"cost": 0.605
}Hailstorm Rooftop Violin Solo
import { createClient } from '@runware/sdk'
const client = await createClient({ apiKey: process.env.RUNWARE_API_KEY })
await client.connect()
const [result] = await client.run({
model: 'lightricks:3@1',
positivePrompt: 'Retake only the selected segment so the rooftop performance suddenly shifts into a violent hailstorm. Keep the same violinist, wardrobe, camera angle, framing, rooftop layout, skyline placement, and motion continuity from the surrounding clip. Dark gust clouds roll in fast, loose sheets snap on a clothesline, hailstones ricochet across puddles and concrete, the musician braces against the wind while continuing to play with intense concentration. Cinematic realism, wet surfaces, sharp atmospheric detail, natural motion blur, believable continuity at the edit boundaries. Replace audio and video with fierce wind, rattling hail impacts, fluttering fabric, distant thunder, and a more forceful, urgent violin phrase that matches the performer’s movements.',
providerSettings: {
lightricks: {
startTime: 2,
duration: 3,
mode: 'replace_audio_and_video'
}
},
inputs: {
video: 'https://assets.runware.ai/assets/inputs/a5fa4c72-d8d2-48e7-bbe7-69107238ef47.mp4'
}
})import asyncio
import os
from runware import Runware
async def main():
async with Runware(api_key=os.environ["RUNWARE_API_KEY"]) as client:
results = await client.run({
"model": "lightricks:3@1",
"positivePrompt": "Retake only the selected segment so the rooftop performance suddenly shifts into a violent hailstorm. Keep the same violinist, wardrobe, camera angle, framing, rooftop layout, skyline placement, and motion continuity from the surrounding clip. Dark gust clouds roll in fast, loose sheets snap on a clothesline, hailstones ricochet across puddles and concrete, the musician braces against the wind while continuing to play with intense concentration. Cinematic realism, wet surfaces, sharp atmospheric detail, natural motion blur, believable continuity at the edit boundaries. Replace audio and video with fierce wind, rattling hail impacts, fluttering fabric, distant thunder, and a more forceful, urgent violin phrase that matches the performer’s movements.",
"providerSettings": {
"lightricks": {
"startTime": 2,
"duration": 3,
"mode": "replace_audio_and_video"
}
},
"inputs": {
"video": "https://assets.runware.ai/assets/inputs/a5fa4c72-d8d2-48e7-bbe7-69107238ef47.mp4"
}
})
asyncio.run(main())curl https://api.runware.ai/v1 \
-H "Authorization: Bearer $RUNWARE_API_KEY" \
-H "Content-Type: application/json" \
-d '[
{
"taskType": "videoInference",
"taskUUID": "fd711854-7776-4ba6-aabc-45346fc7ec37",
"model": "lightricks:3@1",
"positivePrompt": "Retake only the selected segment so the rooftop performance suddenly shifts into a violent hailstorm. Keep the same violinist, wardrobe, camera angle, framing, rooftop layout, skyline placement, and motion continuity from the surrounding clip. Dark gust clouds roll in fast, loose sheets snap on a clothesline, hailstones ricochet across puddles and concrete, the musician braces against the wind while continuing to play with intense concentration. Cinematic realism, wet surfaces, sharp atmospheric detail, natural motion blur, believable continuity at the edit boundaries. Replace audio and video with fierce wind, rattling hail impacts, fluttering fabric, distant thunder, and a more forceful, urgent violin phrase that matches the performer’s movements.",
"providerSettings": {
"lightricks": {
"startTime": 2,
"duration": 3,
"mode": "replace_audio_and_video"
}
},
"inputs": {
"video": "https://assets.runware.ai/assets/inputs/a5fa4c72-d8d2-48e7-bbe7-69107238ef47.mp4"
}
}
]'runware run lightricks:3@1 \
positivePrompt="Retake only the selected segment so the rooftop performance suddenly shifts into a violent hailstorm. Keep the same violinist, wardrobe, camera angle, framing, rooftop layout, skyline placement, and motion continuity from the surrounding clip. Dark gust clouds roll in fast, loose sheets snap on a clothesline, hailstones ricochet across puddles and concrete, the musician braces against the wind while continuing to play with intense concentration. Cinematic realism, wet surfaces, sharp atmospheric detail, natural motion blur, believable continuity at the edit boundaries. Replace audio and video with fierce wind, rattling hail impacts, fluttering fabric, distant thunder, and a more forceful, urgent violin phrase that matches the performer’s movements." \
providerSettings.lightricks.startTime=2 \
providerSettings.lightricks.duration=3 \
providerSettings.lightricks.mode=replace_audio_and_video \
inputs.video=https://assets.runware.ai/assets/inputs/a5fa4c72-d8d2-48e7-bbe7-69107238ef47.mp4{
"taskType": "videoInference",
"taskUUID": "fd711854-7776-4ba6-aabc-45346fc7ec37",
"model": "lightricks:3@1",
"positivePrompt": "Retake only the selected segment so the rooftop performance suddenly shifts into a violent hailstorm. Keep the same violinist, wardrobe, camera angle, framing, rooftop layout, skyline placement, and motion continuity from the surrounding clip. Dark gust clouds roll in fast, loose sheets snap on a clothesline, hailstones ricochet across puddles and concrete, the musician braces against the wind while continuing to play with intense concentration. Cinematic realism, wet surfaces, sharp atmospheric detail, natural motion blur, believable continuity at the edit boundaries. Replace audio and video with fierce wind, rattling hail impacts, fluttering fabric, distant thunder, and a more forceful, urgent violin phrase that matches the performer’s movements.",
"providerSettings": {
"lightricks": {
"startTime": 2,
"duration": 3,
"mode": "replace_audio_and_video"
}
},
"inputs": {
"video": "https://assets.runware.ai/assets/inputs/a5fa4c72-d8d2-48e7-bbe7-69107238ef47.mp4"
}
}{
"taskType": "videoInference",
"taskUUID": "fd711854-7776-4ba6-aabc-45346fc7ec37",
"videoUUID": "cb6f3ad7-5c1d-436c-8bf7-5a05ba1284cc",
"videoURL": "https://vm.runware.ai/video/os/a15d18/ws/5/vi/cb6f3ad7-5c1d-436c-8bf7-5a05ba1284cc.mp4",
"cost": 0.605
}