Wan — Animate an image

POST

/services/aigc/image2video/video-synthesis

cURL - Image to animation

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis' \
  -H 'X-DashScope-Async: enable' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "wan2.2-animate-move",
  "input": {
    "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/adsyrp/move_input_image.jpeg",
    "video_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/kaakcn/move_input_video.mp4",
    "watermark": true
  },
  "parameters": {
    "mode": "wan-std"
  }
}'

{
  "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx",
  "output": {
    "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
    "task_status": "PENDING"
  }
}

Animate a character image by transferring actions and expressions from a reference video. Use it to replicate dances, body movements, and facial expressions — a low-cost alternative to motion capture.

Service modes

wan2.2-animate-move offers two service modes:

Mode	Value	Description
Standard	`wan-std`	Faster and cheaper. Good for quick previews and basic animation.
Professional	`wan-pro`	Smoother and higher quality, but slower and more expensive.

Input requirements

Character image (image_url):

A single front-facing person with an unobstructed face
The person should occupy a moderate portion of the frame
Format: JPG, JPEG, PNG, BMP, or WEBP
Dimensions: 200–4096 px (width and height), aspect ratio 1:3 to 3:1
File size: up to 5 MB

Reference video (video_url):

A single front-facing person with an unobstructed face
Higher resolution and frame rate produce better results
Format: MP4, AVI, or MOV
Duration: 2–30 seconds
Dimensions: 200–2048 px (width and height), aspect ratio 1:3 to 3:1
File size: up to 200 MB

Authorizations

string

header

required

DashScope API Key. Create one in the Qwen Cloud console.

Header Parameters

enum<string>

required

Must be set to enable. HTTP requests support only asynchronous processing. Omitting this header returns a "current user api does not support synchronous calls" error.

Available options:enable

Body

application/json

enum<string>

required

Model name. Must be wan2.2-animate-move.

Available options:wan2.2-animate-move

Example:wan2.2-animate-move

object

required

Input data including the character image and reference video.

Show child attributes

string

required

A publicly accessible URL of the input character image.

Image constraints:

Format: JPG, JPEG, PNG, BMP, or WEBP.
Dimensions: Width and height must both be in the range of [200, 4096] pixels. The aspect ratio must be between 1:3 and 3:1.
File size: Up to 5 MB.
Content: The image must show a single front-facing person with an unobstructed face, occupying a moderate portion of the frame.

URLs containing non-ASCII characters (such as Chinese characters) must be URL-encoded.

Example:https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/adsyrp/move_input_image.jpeg

string

required

A publicly accessible URL of the reference video. The model transfers actions and expressions from this video to the character image.

Video constraints:

Format: MP4, AVI, or MOV.
Duration: 2 to 30 seconds.
Dimensions: Width and height must both be in the range of [200, 2048] pixels. The aspect ratio must be between 1:3 and 3:1.
File size: Up to 200 MB.
Content: The video must show a single front-facing person with an unobstructed face, occupying a moderate portion of the frame.

For better results, use a reference video with higher resolution and frame rate. URLs containing non-ASCII characters must be URL-encoded.

Example:https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/kaakcn/move_input_video.mp4

boolean

defaultfalse

Whether to add a "Generated by Qwen AI" watermark in the lower-right corner of the video.

Example:true

object

required

Video generation parameters.

Show child attributes

enum<string>

required

The service mode.

wan-std: Standard mode. Faster generation at lower cost. Suitable for quick previews and basic animation.
wan-pro: Professional mode. Smoother animation and higher quality, with longer processing time and higher cost.

Available options:wan-std,wan-pro

Example:wan-std

boolean

defaulttrue

Whether to validate the input image.

Example:true

Response

200-application/json

string

Unique request identifier for tracing and troubleshooting.

Example:4909100c-7b5a-9f92-bfe5-xxxxxx

object

Show child attributes

string

Task ID for polling status. Use with GET /tasks/{task_id}. Valid for 24 hours.

Example:0385dc79-5ff8-4d82-bcb6-xxxxxx

enum<string>

Initial task status, typically PENDING.

Available options:PENDING,RUNNING,SUCCEEDED,FAILED,CANCELED,UNKNOWN

Example:PENDING

​Service modes

​Input requirements

Authorizations

Header Parameters

Body

Response

Service modes

Input requirements