Wan 2.2 14B Animate Replace overview
Wan 2.2 14B Animate Replace by Alibaba Cloud
It enables seamless substitution of people in existing footage, maintaining natural motion, facial expressions, and scene lighting.
Wan 2.2 14B Animate Replace specs
- Model ID
wan/v2.2-14b/animate/replace- Developer
- Alibaba Cloud
- Input
- Text, Image, Video
- Output
- Video
- Endpoint
POST https://api.aimlapi.com/v2/video/generations
Wan 2.2 14B Animate Replace is an advanced AI video generation model designed for precise character replacement in existing videos. The model maintains the original video's scene, background, camera angles, and timing, while replacing the person in the video with a new character based on a reference photo. Replacement can be limited to the face or include the full body, preserving body poses and synchronized lip movements.
Technical Specifications
- Model Size: 14 billion parameters in the generation backbone.
- Architecture: Diffusion transformer video generator with mixture-of-experts design for enhanced capacity at efficient compute cost.
- Latent Space Processing: Uses a custom 3D causal variational autoencoder (VAE) (~127M parameters) for spatio-temporal latent video compression.
- Causality: Temporal causality ensures future frames don't influence past frames, enabling stable and coherent motion generation.
- Attention Mechanism: Pooled spatio-temporal self-attention across frames and pixels.
- Conditioning: Cross-attention to text features via a T5 encoder for optional text-driven control.
- Input: Single reference image (identity) + reference video (motion).
- Output: Video with replaced character, 720p resolution at 24 fps.
Performance Benchmarks
- Video Quality: High-fidelity character replacement with smooth motion and natural facial expressions.
- Resolution and Frame Rate: Supports 720p resolution at 24 frames per second.
- Latency: Local generation speed depends on GPU; H100 GPUs yield significantly faster inference than consumer GPUs.
- Resource Efficiency: Mixture-of-experts architecture enhances model capacity without proportional increase in compute cost.
Key Features
- Character Replacement: Swap the original person in a video with a new one from a single reference image.
- Full or Partial Replacement: Choose between just face replacement or full body substitution.
- Pose and Expression Preservation: Maintain the original body pose, head movements, and lip synchronization for natural animation.
- Scene Consistency: Keeps background, camera angles, lighting, and timing intact.
- High Realism: Uses skeleton-based motion tracking and fine facial encoding for smooth, realistic animations.
- Local Deployment: Can run locally with appropriate hardware setups, supporting high-quality output.
Comparison with Other Models
vs Stable Diffusion Video: Wan 2.2 emphasizes end-to-end character replacement in videos with holistic expression and motion transfer, surpassing Stable Diffusion extensions which mainly support short clip generation and less consistent temporal control. Wan 2.2 can handle longer videos (up to several minutes) compared to typically shorter outputs from Stable Diffusion video models.
vs Imagen Video (Google): Imagen Video focuses largely on video generation from text prompts with high visual quality but lacks specific character replacement features. Wan 2.2’s unique selling point is unifying animation and replacement modes with detailed control over expressions and motion, catering to character-centric workflows.
vs Meta Make-A-Video: Wan 2.2 specializes in character replacement with precise synchronization of pose and lips in existing videos, whereas Make-A-Video generates short video clips from text without targeted character substitution. Make-A-Video focuses on general scene creation, making Wan 2.2 more practical for post-production and video editing.
API Integration
Accessible via AI/ML API. Documentation: available here.
Use cases
- Video character replacement for advertising and marketing content
- Virtual influencer and avatar creation with real-time expression mimicking
- Film and video pre-visualization and reshoots without new filming
- Personalized user-generated content with custom characters
- Animation of photos for social media and entertainment
- Educational and training video customization
- Privacy-preserving content creation by replacing faces in existing footage
- Digital effects and deepfake production with ethical controls
Wan 2.2 14B Animate Replace API pricing
| Usage | Price | Unit |
|---|---|---|
| Video generation | $0.04 | per generation |
| Additional | $0.104 | per generation |
Prices from the AI/ML API price list, checked on Nov 4, 2026.
Wan 2.2 14B Animate Replace vs other video models: prices
AI/ML API rates for 5 models, per generation.
| Model | Per generation |
|---|---|
 Wan 2.2 14B Animate Replace | $0.04 |
 Seedance 2.0 Mini | $0.04 |
| Wan 2.2 14B Animate Move | $0.04 |
| Wan 2.2 Vace Depth | $0.05 |
| Wan 2.2 Vace Inpainting | $0.05 |
How to use the Wan 2.2 14B Animate Replace API
View docs
Build with your agent
Give your agent the model details, code and documentation.
1Get your API key
Create API keyexport AIMLAPI_KEY="8f2b4c7d9a1e6b3f…"2Make your first request
curl 'https://api.aimlapi.com/v2/video/generations' \
-H "Authorization: Bearer $AIMLAPI_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "wan/v2.2-14b/animate/replace",
"video_url": "https://example.com/input.mp3",
"image_url": "https://example.com/input.jpg"
}'import os
import requests
headers = {
"Authorization": f"Bearer {os.environ['AIMLAPI_KEY']}",
"Content-Type": "application/json",
}
payload = {
"model": "wan/v2.2-14b/animate/replace",
"video_url": "https://example.com/input.mp3",
"image_url": "https://example.com/input.jpg"
}
response = requests.post("https://api.aimlapi.com/v2/video/generations", headers=headers, json=payload, timeout=120)
response.raise_for_status()
print(response.json())const response = await fetch("https://api.aimlapi.com/v2/video/generations", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.AIMLAPI_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"model": "wan/v2.2-14b/animate/replace",
"video_url": "https://example.com/input.mp3",
"image_url": "https://example.com/input.jpg"
}),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());The request returns a generation id. Poll GET https://api.aimlapi.com/v2/video/generations?generation_id=<id> until the status is completed.
Models similar to Wan 2.2 14B Animate Replace
Related articles
Wan 2.2 14B Animate Replace FAQ
What inputs and outputs does Wan 2.2 14B Animate Replace support?
Wan 2.2 14B Animate Replace takes image, video as input and returns video.
How much does Wan 2.2 14B Animate Replace cost?
Wan 2.2 14B Animate Replace costs $0.04 per generation on AI/ML API, billed as you go with no subscription.
How is Wan 2.2 14B Animate Replace billed?
Wan 2.2 14B Animate Replace is billed per generation, a fixed charge per output rather than by prompt length.
Can Wan 2.2 14B Animate Replace take an existing image as input?
Yes, Wan 2.2 14B Animate Replace accepts image input as well as a text prompt.
Who created Wan 2.2 14B Animate Replace?
Wan 2.2 14B Animate Replace was built by Alibaba Cloud.
How do I call Wan 2.2 14B Animate Replace on AI/ML API?
Send a request to v2/video/generations with wan/v2.2-14b/animate/replace as the model id.
Is Wan 2.2 14B Animate Replace available through a single API key?
Yes. Wan 2.2 14B Animate Replace is served through AI/ML API, so the same key and endpoint format used for other models applies.
What is the Wan 2.2 14B Animate Replace model ID?
Use wan/v2.2-14b/animate/replace as the model parameter. Requests go to https://api.aimlapi.com/v2/video/generations with your AI/ML API key.