Wan 2.2 Animate API

Introduction

Wan 2.2 Animate turns an approved character image and a separate motion reference into a new character-performance clip. Use it when appearance and movement have already been decided in different assets, rather than asking one source to supply both.

It works in two modes. With animation_mode set to animate, the character from your image moves with the motion of the driving video; with replace, the person in the driving video is swapped for the one in your image and the video's own scene is kept. The output runs as long as the driving video, 2 to 30 seconds, at 480p or 720p.

Key features

A clean A-pose is worth more than a long prompt

The published reference plate is the kind of image this endpoint wants: whole body in frame, neutral A-pose, seamless backdrop, even light. Everything the output looks like comes from that image. A cropped or heavily occluded plate limits every clip you will ever make from it, and no prompt recovers it.

The clip is as long as the source, up to 30 seconds

The output is as long as the driving video, which must run 2 to 30 seconds, so a two-minute source has to be trimmed first.

Check the likeness at 480p before paying for 720p

The published clip is that same plate driven by a reference video: same burgundy top, same wide-leg trousers, now mid-turn.

Request parameters

Pricing

Prices are in credits, the same credits you use on the website (1 credit = $0.01). The hold is taken when the task is accepted and settled to the actual charge when it finishes; failed tasks are refunded.

For an exact number before you run, send the same body to POST /jobs/quote.

Use cases

Put your character into existing footage

With animation_mode set to replace, the person in the driving video is swapped for the character in your image while the footage keeps its own scene. Use it when the location already exists on video and only the performer needs to change.

Short loops from one character sheet

Up to 30 seconds covers a feed loop, a sticker or a reaction clip. Keep one plate and swap driving videos to build a library of gestures, such as a wave, a turn or a shrug, that all read as the same character because they share the same reference image.

Dance and performance routines

A character plate plus a driving video of the routine you want: wardrobe and build stay fixed by the plate while timing, weight and camera come from the footage. What bounds the work is ownership: you need the rights to both the plate and the driving video, and you are responsible for how the result is used.

Testing a plate before a longer render

Run a five-second 480p transfer to see whether a new character plate holds its face, hands and silhouette under motion.

Prompt guide & pro tips

Build the character plate

Whole body in frame, neutral pose, plain backdrop, even light. This image decides the face, the wardrobe and the proportions of every clip you drive with it, so it is worth generating and rejecting a few before you commit. If no face or person can be found in it, the task is rejected with invalid_request.

Use the prompt for style, not identity

prompt is optional and takes up to 2000 characters. It guides the animation style and content; identity belongs to the character image. Fix seed when you want to compare two runs over the same driving video.

Check the result before iterating

Both inputs are required and not interchangeable: identity comes from the image, motion from the video. In animate mode the setting stays with the character image; in the reference run the driving video was shot in a kitchen and the result stayed on the plate's grey studio backdrop, with only the movement and camera carried across. A longer source is not compressed, so trim it before you upload.

API quick start

Call the Wan 2.2 Animate API in three steps

1. Create an API key. Sign in to PopNow and create a key in the API console. Keys start with sk-popnow- and use the same credits as the website.
2. Send the request. POST /jobs/createTask with model alibaba/wan-2.2-animate/character-animation and an input object that follows the parameter table. The response returns a task ID straight away.
3. Get the result. Poll GET /jobs/recordInfo with the task ID, or pass a callBackUrl and we post the result to it. Download the output links when the task succeeds.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "alibaba/wan-2.2-animate/character-animation",
  "input": {
    "animation_mode": "animate",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "resolution": "720p"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Replace the prompt and any links with your own. The API tab has the response, polling and callback reference.

Wan 2.2 Animate API questions

All Wan models

Kling 3.0 Motion Control does the same job at up to 1080p for the most polished result.

• Wan 3.0 APIUp to 30-second clips with synced audioFrom 34 credits for a 5-second clip
• Wan 3.0 Prime APIQuicker Wan 3.0 renders, up to 30 seconds with audioFrom 46 credits for a 5-second clip
• Wan 3.0 Pro Prime APIQuicker Wan 3.0 Pro with 2K and 4K outputFrom 176 credits for a 5-second clip
• Wan 3.0 Pro APIWan 3.0 at 1080p, 2K or 4K, up to 30 secondsFrom 108 credits for a 5-second clip
• Wan 2.7 Pro APILarge 4K canvases and nine-image compositesFrom 12 credits per image
• Wan 2.7 APIThinks through the composition, then draws up to four imagesFrom 5 credits per image
• Wan 2.6 Flash APIQuick multi-shot clips from a single imageFrom 17 credits for a 5-second clip
• Wan 2.6 APIMulti-shot sequences with sound at up to 1080pFrom 49 credits for a 5-second clip
• Wan 2.5 API1080p clips with sound that can follow your own audioFrom 34 credits for a 5-second clip
• Wan 2.2 Animate APIDrive a character photo with a reference videoFrom 7.95 credits per second
• Wan 2.2 LoRA APIWan 2.2 video with your LoRAs on either expert passFrom 18 credits for a 5-second clip
• Wan 2.2 APISimple five-second clips at 480p or 720pFrom 36 credits per run
• Wan 2.2 5B LoRA APILight 720p Wan 2.2 clips that load your own LoRAsFrom 18 credits per run
• Wan 2.2 Image LoRA APIWan 2.2 stills with up to nine LoRAs across three slotsFrom 5 credits per image
• Wan 2.1 LoRA APIWan 2.1 video and edits with your own LoRAs, camera moves includedFrom 36 credits per run
• Wan 2.1 Image LoRA APIPhotoreal Wan 2.1 stills and restyles with your LoRAsFrom 5 credits per image

Other video APIs

• MiniMax H3 APIExpressive clips with audio, up to 2KFrom 28 credits for a 5-second clip
• Kling 3.0 API4K clips, multi-shot cuts and motion controlFrom 51 credits for a 5-second clip
• Kling 2.6 API1080p clips with optional sound and motion controlFrom 52 credits for a 5-second clip

More about Wan 2.2 Animate

Try it

Wan 2.2 Animate AI Motion Control onlineCreate videos with Wan 2.2 Animate in PopNow

Docs

Wan 2.2 Animate model ID and input schema in the API docsPopNow API quickstart: your first request in five minutesImage to video guide for the PopNow APIWebhooks: get Wan 2.2 Animate results without polling