Lucy
Edit video in realtime with controlled, targeted prompts
2 credits per second
import { createDecartClient, models } from "@decartai/sdk";
const model = models.realtime("lucy-2.1");
// Get user's camera stream with model specifications
const stream = await navigator.mediaDevices.getUserMedia({
audio: true,
video: {
frameRate: model.fps,
width: model.width,
height: model.height,
}
});
// Create a client
const client = createDecartClient({
apiKey: "your-api-key-here"
});
// Connect and edit the video stream
const realtimeClient = await client.realtime.connect(stream, {
model,
mirror: "auto",
onRemoteStream: (editedStream) => {
// Display the edited video
const videoElement = document.querySelector("#video-output");
videoElement.srcObject = editedStream;
}
});
// set() replaces the full state — prompt + image atomically
await realtimeClient.set({
prompt: "A person wearing a superhero costume",
enhance: true,
image: "https://example.com/superhero-reference.png",
});
// Prompt-only update
await realtimeClient.set({ prompt: "Add sunglasses to the person" });
// setPrompt() also works as a shorthand
await realtimeClient.setPrompt("Change the person's shirt to red");
// Disconnect when done
realtimeClient.disconnect();
Available Endpoints
Request Parameters
promptRequiredType:string
Edit description for live transformation
streamRequiredType:File
Video stream (WebRTC)
Parameter
Type
Required
Description
promptstringYesEdit description for live transformationstreamFileYesVideo stream (WebRTC)Lucy
Edit video in realtime with controlled, targeted prompts
Lucy enables targeted video edits, modifying specific elements while preserving the rest. Edit infinite long videos in realtime, with zero latency, and see your changes as you type.
Pricing
Model
Lucy 2.1
720p
2 Creditsper 1s
Model
Lucy 2.1 VTON
720p
2 Creditsper 1s
Model
Lucy VTON 2
720p
2 Creditsper 1s
Video models are charged per second of generated video. Final cost depends on video duration and selected resolution.