wan / 2-2-animate-replace
Commercial usePart of the Wan API family — compare all Wan models →

Wan 2.2 Animate API by Alibaba’s Tongyi Lab generates realistic character videos with motion, expressions, and lighting. It supports animation mode for driving static images and replacement mode for swapping characters into existing clips seamlessly.

Model Type:
Pricing: Your request will cost 12.5 Kie credits per video-second for 720 p (≈ $0.0625), 9.5 Kie credits per video-second for 580 p (≈ $0.0475), and 6 Kie credits per video-second for 480 p (≈ $0.0300). Each job can be up to 30 seconds long, and these rates are about 20–25 % cheaper than the official pricing. High-tier top-ups include +10% bonus credits. Effective pricing is approximately 10% lower than the above rates.
Input

Click to upload or drag and drop

Supported formats: MP4, QUICKTIME, X-MATROSKA Maximum file size: 10MB

URL of the input video.

Click to upload or drag and drop

Supported formats: JPEG, PNG, WEBP Maximum file size: 10MB

URL of the input image. If the input image does not match the chosen aspect ratio, it is resized and center cropped.

Resolution of the generated video (480p, 580p, or 720p).

A configurable parameter. Defaults to true in the Playground.

There is no guarantee that everything can be filtered out; if you are not satisfied with the results, you will need to make your own arrangements.
Output
output typevideo
Examples

Explore different use cases and parameter configurations

README

Complete guide to using Wan 2.2 Animate

Unified Character Animation and Replacement with Wan 2.2 Animate API

Bring your characters to life with wan 2.2 animate api. On Kie.ai, you can animate portraits, illustrations, or character images by combining them with reference videos—no local deployment or complex setup required.

Wan 2.2 Animate API Modes on Kie.ai

Wan2.2-Animate-14B API for Animation

Upload a static character image and a reference video, and wan2.2-animate api for animation transfers body motion and facial expressions to create a new video. The output keeps the original background intact, making it ideal for avatars, art projects, and creative media.

Wan2.2-Animate-14B API for Character Replacement

With wan2.2-animate api for replacement, you can swap the subject in a reference video with your chosen character image. The system automatically adjusts lighting and tone for natural blending, ensuring professional and seamless results.

Key Features of Wan 2.2 Animate API

Animate Any Character with Wan Animate API

Wan 2.2 Animate API can turn portraits, sketches, or character images into dynamic videos. With Photo Animate AI, static visuals gain realistic body movement and facial expressions, making it ideal for avatars, digital art, and social media content.

Character Replacement with Seamless Environmental Integration

Wan2.2 animate api allows you to replace characters in existing videos. It integrates the new character seamlessly into the scene, preserving lighting and tone for natural results.

Expressive Animation with Wan 2.2 Animate API

Wan 2.2 animate api captures subtle facial details for expressive human animation and also generalizes to arbitrary characters such as animals, cartoons, and stylized art.

Dynamic Motion Using Wan Animate API

Through skeleton-based tracking, wan animate api ensures smooth and consistent body movements across sequences, even for complex performances like dance or action scenes.

Consistent Lighting with Alibaba Wan Animate API

Alibaba wan animate api applies relighting technology to replicate shadows, highlights, and tones, ensuring characters blend naturally with the video environment.

Preserve Audio in Wan 2.2 Animate API Outputs

When generating results, wan 2.2 animate api retains the original video audio, keeping background music, dialogue, or ambient sound perfectly aligned with the new visuals.

How to Use Wan 2.2 Animate API Online Free

Step 1: Register and Get Free Wan 2.2 Animate API Key

Create an account on Kie.ai and receive your free wan 2.2 animate api key. This key allows you to access the API directly or test it in the playground without local setup.

Step 2: Choose Mode and Upload Inputs

Select between Move (Animation) or Replace (Character Swap). Upload a photo of your character and add a reference video. With wan2.2 animate api, the system transfers motion and expressions or replaces the subject in the video.

Step 3: Test in Playground or Call Wan 2.2 Animate API

You can run your project in the online playground for instant results or call the wan animate api programmatically using your API key. Both options give you flexibility to experiment or integrate into production workflows.

Why Kie.ai is the Best Platform for Wan 2.2 Animate API

Animate Move and Animate Replace on One Endpoint

wan/2-2-animate-move and wan/2-2-animate-replace run on POST /api/v1/jobs/createTask, and each request takes one input video and one image. Pass a callBackUrl to receive the result when the task finishes, verify each callback with the HMAC signature described in the Kie.ai webhook guide, and query Get Task Details for the authoritative result. Pricing for each resolution is shown in the pricing card above.

Pass Uploaded File URLs, Not File Content

Both inputs must be file URLs, not file content: the video as MP4, MOV or MKV and the image as JPEG, PNG or WebP, each up to 10MB. Files that are not hosted yet can be uploaded first with the Kie.ai File Upload API (Base64, file stream or remote URL).

Resolution Starts at the Lowest Tier

Output resolution defaults to 480p unless you choose one of the two higher tiers, up to 720p. New Kie.ai users receive 80 free credits for testing. The full parameter list is in the playground and API docs above.

4.8/ 5
34,774 ratings
Tap a star to rate

Use Cases of Wan 2.2 Animate API

Short Video Creation for Social Platforms

Creators can use wan 2.2 animate api to quickly generate short videos from static photos. By applying reference video motion, users produce engaging clips for TikTok, Instagram Reels, and YouTube Shorts without heavy editing tools.

Dance Template Generation with Wan Animate API

With wan animate api, a static character can be animated to follow dance movements from a reference video. This makes it easy to create dance templates for social challenges, music videos, or interactive performances.

Anime and Animation Production Using Wan2.2 Animate API

Studios and independent artists apply wan2.2 animate api to animate drawn characters or stylized art. This accelerates anime production and experimental animation projects, allowing sketches and illustrations to gain natural motion and expression.

Frequently Asked Questions

Wan 2.2 animate api is a model that animates static character images using motion and expressions from a reference video. It supports two main modes: animation (driving a static photo) and replacement (swapping characters in video).

Yes. Kie.ai offers a free wan animate api online playground where you can upload a photo and a reference video to generate animations instantly, without local installation.

With wan2.2-animate api, you can insert a new character image into a video while preserving the original scene’s lighting and tone. This makes the replacement look seamless and natural.

Wan 2.2 animate api accepts static character images as input, along with a reference video. In animation mode, the image is animated according to the reference video’s motion and expressions. In replacement mode, the image replaces the subject in the video while matching lighting and tone.

Yes, wan 2.2 animate api is open-source, but running it locally requires powerful hardware and technical setup. On Kie.ai, you can use the online wan animate api without complex configuration—simply upload your inputs and start generating animations right away.

Yes, wan 2.2 animate api keeps the original audio track so music, dialogue, and ambient sound stay aligned with the new visuals.