Skip to main content
POST
/
wan2.2-animate-move
/
async
curl --request POST \
  --url https://api.modellix.ai/api/v1/alibaba/wan2.2-animate-move/async \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "image_url": "https://example.com/person.jpg",
  "video_url": "https://example.com/dance.mp4",
  "mode": "wan-std"
}
'
{
  "code": 0,
  "message": "success",
  "data": {
    "status": "pending",
    "task_id": "task-abc123",
    "model_id": "model-123",
    "get_result": {
      "method": "GET",
      "url": "https://api.modellix.ai/api/v1/tasks/task-abc123"
    }
  }
}

Authorizations

​
Authorization
string
header
required

API Key authentication. Format: Bearer YOUR_API_KEY.

Body

application/json
​
image_url
string<uri>
required

Input character image URL (HTTP/HTTPS, publicly accessible, no Chinese or non-ASCII characters). Format: JPG/JPEG/PNG/BMP/WEBP. Size: width and height both in [200, 4096] pixels, aspect ratio 1:3 to 3:1. File size: ≤ 5MB. Content requirement: single person facing camera, full face visible without obstruction, moderate proportion in frame (avoid too large or too small)

Example:

"https://example.com/person.jpg"

​
video_url
string<uri>
required

Reference motion video URL (HTTP/HTTPS, publicly accessible, no Chinese or non-ASCII characters). Format: MP4/AVI/MOV. Duration: 2-30 seconds. Size: width and height both in [200, 2048] pixels, aspect ratio 1:3 to 3:1. File size: ≤ 200MB. Content requirement: single person facing camera, full face visible without obstruction, moderate proportion in frame. Tip: Higher resolution and frame rate of reference video can improve output quality

Example:

"https://example.com/dance.mp4"

​
mode
enum<string>
required

Model service mode. Options: (1) 'wan-std': Standard mode - faster generation speed, cost-effective, suitable for quick preview and basic animation scenarios; (2) 'wan-pro': Professional mode - higher animation smoothness and better quality, longer processing time and higher cost, suitable for final production output

Available options:
wan-std,
wan-pro
Example:

"wan-std"

​
check_image
boolean
default:true

Whether to perform image detection. When true (default), the API validates the input image for quality and content requirements. When false, skips image detection for faster processing. Set to false only when you're confident the image meets all requirements

Example:

true

Response

200 - application/json

Task submitted successfully

​
code
integer
required

Response code, 0 indicates success

Example:

0

​
message
string
required

Response message

Example:

"success"

​
data
object
required