Decart Logo
    • Real-time
  • Mirage LSD
    Mirage LSDRealtime Video Restyling
  • Lucy Edit Live
    Lucy Edit LiveRealtime Video Editing
  • LipSync Live
    LipSync LiveRealtime Lips movement
    • Video models
  • Lucy
    LucyText/Image to Video
  • Lucy Edit
    Lucy EditVideo to Video
    • Image models
  • Lucy Image
    Lucy ImageText to Image
  • Lucy Image Edit
    Lucy Image EditImage to Image
  • Cookbook icon
    Cookbook
  • Documentation icon
    Documentation
  1. Models
  3. Lucy
Lucy icon

Lucy

Lucy is a model that generates videos from text descriptions or with an image as initial frame.

Lucy is a model that generates videos from text descriptions or with an image as initial frame.

Documentation
Your browser does not support the video tag.
import { readFile } from "node:fs";
import { createDecartClient, models } from "@decartai/sdk";

const client = createDecartClient({
  apiKey: "--your-api-key--"
});

const image = await readFile("/path/to/photo.jpg");

const result = await client.process({
  model: models.video("lucy-pro-i2v"),
  prompt: "Make the leaves gently sway in the wind",
  data: image,
});

Available Endpoints

Request Parameters

promptRequired
Type:string

Describe how you want to animate the image. Specify motion types, camera movements, and effects. Keep the motion description natural and realistic.

dataOptional
Type:File

The image you want to animate. Supports JPEG, PNG, and WebP formats up to 5MB.

resolutionOptional
Type:string

Output video resolution. Higher resolutions provide more detail but take longer to generate. Dev version only supports 720p. (default: 720p) (options: 480p, 720p)

Parameter
Type
Required
Description
promptstringYesDescribe how you want to animate the image. Specify motion types, camera movements, and effects. Keep the motion description natural and realistic.
dataFileNoThe image you want to animate. Supports JPEG, PNG, and WebP formats up to 5MB.
resolutionstringNoOutput video resolution. Higher resolutions provide more detail but take longer to generate. Dev version only supports 720p. (default: 720p) (options: 480p, 720p)

Lucy

Quickly generate videos from text prompts and image input

Lucy creates stunning video clips from your static visuals. Animate still photos with natural, nuanced motion. Lucy is the fastest video model on the market, and is also available in pro for even higher quality results.

Pricing

Model
pro
480p
4 Creditsper 1s
720p
8 Creditsper 1s
Model
dev
720p
3 Creditsper 1s

Video models are charged per second of generated video. Final cost depends on video duration and selected resolution.

Examples