Skip to main content
POST
/
wan2.2-animate-mix
/
async
curl --request POST \
  --url https://api.modellix.ai/api/v1/alibaba/wan2.2-animate-mix/async \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "image_url": "https://example.com/new_actor.jpg",
  "video_url": "https://example.com/original_scene.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

Character image URL to replace the video protagonist (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: ensure the character in image has similar aspect ratio to the character in reference video for best results

Example:

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

​
video_url
string<uri>
required

Reference video URL with the original character to be replaced (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. The model will replace the character in this video while preserving scene, lighting, and color tone. Tip: Higher resolution and frame rate improve output quality

Example:

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

​
mode
enum<string>
required

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

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

"wan-std"

​
check_image
boolean
default:true

Whether to perform image quality detection. When true (default), validates input image quality and content. When false, skips detection for faster processing. Recommended to keep true for production use to ensure best results

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