Aliyun Wan Animate Move

Wan 2.2 Animate Move (Image-to-Motion)

Validation

mkdir -p output/aliyun-wan-animate-move
python -m py_compile skills/ai/video/aliyun-wan-animate-move/scripts/generate_animate_move.py && echo "py_compile_ok" > output/aliyun-wan-animate-move/validate.txt

Pass criteria: command exits 0 and output/aliyun-wan-animate-move/validate.txt is generated.

Output And Evidence

• Save task IDs, polling responses, and final video URLs to output/aliyun-wan-animate-move/.
• Keep at least one end-to-end run log for troubleshooting.

Prerequisites

• Install SDK (recommended in a venv):

python3 -m venv .venv
. .venv/bin/activate
python -m pip install requests

• Set DASHSCOPE_API_KEY in your environment, or add dashscope_api_key to ~/.alibabacloud/credentials.

Critical model names

• wan2.2-animate-move -- supports motion transfer from reference video to character image

Capabilities

Service modes

API endpoint (async only)

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis

Required headers:

• Authorization: Bearer $DASHSCOPE_API_KEY
• Content-Type: application/json
• X-DashScope-Async: enable

Singapore endpoint: replace dashscope.aliyuncs.com with dashscope-intl.aliyuncs.com.

Normalized interface

Request

• image_url (string, required) -- public HTTP/HTTPS URL of the character image
• video_url (string, required) -- public HTTP/HTTPS URL of the reference motion video
• watermark (boolean, optional) -- add watermark (default: false)
• mode (string, required) -- wan-std or wan-pro
• check_image (boolean, optional) -- whether to perform image detection (default: true)

Image input limits

• Formats: JPG, JPEG, PNG, BMP, WEBP
• Resolution: [200, 4096] pixels per side
• Aspect ratio: 1:3 to 3:1
• Max size: 5MB
• Content: single person, facing camera, face fully visible, moderate proportion in frame

Video input limits

• Formats: MP4, AVI, MOV
• Duration: 2-30s
• Resolution: [200, 2048] pixels per side
• Aspect ratio: 1:3 to 3:1
• Max size: 200MB
• Content: single person, facing camera, face fully visible, moderate proportion in frame

Response (task creation)

• output.task_id (string) -- use for polling, valid 24 hours
• output.task_status (string) -- PENDING | RUNNING | SUCCEEDED | FAILED | CANCELED | UNKNOWN
• request_id (string)

Response (task result)

• output.video_url (string) -- generated video URL
• usage.video_count (integer)
• usage.video_duration (integer) -- duration in seconds

Quick start (Python + HTTP)

import os
import json
import time
import requests

API_KEY = os.getenv("DASHSCOPE_API_KEY")
BASE_URL = "https://dashscope.aliyuncs.com/api/v1"

def create_animate_move_task(image_url: str, video_url: str, mode: str = "wan-std") -> str:
    """Create an animate-move task and return task_id."""
    payload = {
        "model": "wan2.2-animate-move",
        "input": {
            "image_url": image_url,
            "video_url": video_url,
            "watermark": False,
        },
        "parameters": {
            "mode": mode,
        },
    }
    resp = requests.post(
        f"{BASE_URL}/services/aigc/image2video/video-synthesis",
        headers={
            "Authorization": f"Bearer {API_KEY}",
            "Content-Type": "application/json",
            "X-DashScope-Async": "enable",
        },
        json=payload,
    )
    resp.raise_for_status()
    data = resp.json()
    return data["output"]["task_id"]


def poll_task(task_id: str, interval: int = 15) -> dict:
    """Poll until task completes. Returns final response."""
    while True:
        resp = requests.get(
            f"{BASE_URL}/tasks/{task_id}",
            headers={"Authorization": f"Bearer {API_KEY}"},
        )
        resp.raise_for_status()
        data = resp.json()
        status = data["output"]["task_status"]
        if status in ("SUCCEEDED", "FAILED", "CANCELED"):
            return data
        time.sleep(interval)

Error handling

Output location

• Default output: output/aliyun-wan-animate-move/videos/
• Override base dir with OUTPUT_DIR.

Anti-patterns

• Do not use model names other than wan2.2-animate-move.
• Do not call this API synchronously -- async header is required.
• Do not use multiple people in image or video -- single person only.
• Video URLs expire after 24 hours; download and persist immediately.
• Do not use images with occluded faces or extreme proportions.

Workflow

1) Confirm user intent: transfer motion from reference video to character image. 2) Select service mode: wan-std (fast/cheap) or wan-pro (high quality). 3) Prepare image URL and video URL with valid formats and dimensions. 4) Create async task and poll for results. 5) Download and save generated video before URL expiration.

References

• See references/api_reference.md for full HTTP API details.
• See references/sources.md for source links.

DashScope API Reference (Wan 2.2 Animate Move)

Model

Endpoint

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis

Singapore: https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis

Required headers

Request body

{
  "model": "wan2.2-animate-move",
  "input": {
    "image_url": "https://example.com/person.jpg",
    "video_url": "https://example.com/dance.mp4",
    "watermark": false
  },
  "parameters": {
    "mode": "wan-std",
    "check_image": true
  }
}

input fields

Image requirements

Video requirements

parameters fields

Task creation response

{
  "output": {
    "task_status": "PENDING",
    "task_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  },
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Task polling

GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}
Header: Authorization: Bearer $DASHSCOPE_API_KEY

Success response

{
  "request_id": "...",
  "output": {
    "task_id": "...",
    "task_status": "SUCCEEDED",
    "video_url": "https://..."
  },
  "usage": {
    "video_count": 1,
    "video_duration": 5
  }
}

Task statuses

Sources

• 万相-图生动作API参考 -- Official API documentation
• 视频生成模型概览 -- Model overview and selection guide
• 模型价格 -- Pricing details
• 上传文件获取临时URL -- File upload for OSS temporary URLs