Lucy 2 supports both character reference images and text-only editing in one model. Get started →
Available Models
Lucy 2 Realtime
Character Transform & EditingBecome any character live on camera with reference images, or edit video with text prompts. Our most advanced realtime model.
Mirage Realtime
Style TransferTransform the entire visual style of a live video stream — anime, cyberpunk, oil painting, and more.
Avatar Live
Talking AvatarsAnimate any portrait with audio. Build virtual presenters and AI agents.
Lucy Batch
Video Generation & EditingGenerate videos from text, animate images, or transform existing videos with batch processing.
Image Models
Image Generation & EditingGenerate images from text or edit existing images with precise control.
Lucy Motion
Motion ControlControl object motion with precise trajectory paths in your videos.
Model Comparison
Realtime models
Realtime models process live video and audio over WebRTC with sub-second latency. They run continuously as long as the connection is open.| Model | ID | Use Case | Resolution | Connection |
|---|---|---|---|---|
| Lucy 2 | lucy_2_rt | Character transformation + text editing | 1280×704 | WebRTC |
| Mirage v2 | mirage_v2 | Full video restyling | 1280×704 | WebRTC |
| Mirage | mirage | Video restyling (original) | 1280×704 | WebRTC |
| Lucy 1 | lucy_v2v_720p_rt | Text-based video editing | 1280×704 | WebRTC |
| Avatar Live | live_avatar | Animate portraits with audio | 1280×720 | WebRTC |
Batch models
Batch models process pre-recorded video and images asynchronously. Submit a job, poll for completion, then download the result.| Model | Use Case | Max Resolution | API Endpoint |
|---|---|---|---|
| Lucy Pro T2V | Generate videos from text | 1280×720 | /v1/jobs/lucy-pro-t2v |
| Lucy Pro I2V | Animate images | 1280×720 | /v1/jobs/lucy-pro-i2v |
| Lucy Pro V2V | Transform and edit videos | 1280×720 | /v1/jobs/lucy-pro-v2v |
| Lucy Fast V2V | Transform and edit videos (fast) | 1280×720 | /v1/jobs/lucy-fast-v2v |
| Lucy Motion | Control object motion with trajectory | 1280×720 | /v1/jobs/lucy-motion |
| Lucy Dev I2V | Animate images (faster) | 1280×720 | /v1/jobs/lucy-dev-i2v |
| Lucy Pro T2I | Generate images from text | 1280×720 | /v1/generate/lucy-pro-t2i |
| Lucy Pro I2I | Edit and transform images | 1280×720 | /v1/generate/lucy-pro-i2i |
Technical Specifications
Video Requirements
All video models accept MP4 files with these specifications:- Format: MP4 (H.264 or VP8 codec)
- Aspect Ratio: 16:9 or 9:16
- File Size: Maximum 300MB
Model Capabilities
- Lucy 2 Realtime
- Mirage Realtime
- Batch (Video)
- Avatar Live
Strengths:
- Character transformation with reference images
- Text-based video editing (add, modify, remove objects)
- Atomic
set()updates for prompt + image - WebRTC with sub-second latency
- Virtual cosplay and character-driven content
- Live streaming with character transforms
- Interactive experiences and AR-style effects
- Virtual try-on applications
Choosing the Right Model
Decision Matrix
| If you need to… | Use this model | Why? |
|---|---|---|
| Transform into a character live on camera | Lucy 2 (lucy_2_rt) | Character reference + text editing in one model |
| Edit live video with text prompts | Lucy 2 (lucy_2_rt) | Realtime object and scene edits from text prompts |
| Apply artistic styles to a live stream | Mirage (mirage_v2) | Full scene restyling in realtime |
| Create talking avatars from portraits | Avatar Live (live_avatar) | Audio-driven avatar animation |
| Generate video from text prompt | Lucy Pro T2V | Highest quality text-to-video |
| Animate a still image | Lucy Pro I2V | Best image-to-video quality |
| Control object motion with precise trajectory | Lucy Motion | Path-based animation control |
| Transform or edit existing video (best quality) | Lucy Pro V2V | Highest quality video editing |
| Transform or edit existing video (fast) | Lucy Fast V2V | Fast processing with good quality |
| Generate an image from text | Lucy Pro T2I | Best text-to-image quality |
| Edit or transform an image | Lucy Pro I2I | Precise image editing |
| Process images to video quickly | Lucy Dev I2V | Faster alternative for I2V |
Quick Start Examples
Pricing
For detailed pricing information, see the Pricing page.
Next Steps
Lucy 2 Guide
Character transformation with reference images in realtime
Use Cases
Explore what you can build with realtime and batch models
Quickstart Guide
Transform your first video in minutes
API Reference
Detailed API documentation
JavaScript SDK
Build with our JavaScript SDK
Streaming Best Practices
Optimize your realtime integration