Wan — Swap video character

POST

/services/aigc/image2video/video-synthesis

cURL (Submit Task)

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
  "model": "wan2.2-animate-mix",
  "input": {
    "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/bhkfor/mix_input_image.jpeg",
    "video_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/wqefue/mix_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"
  }
}

The model replaces the main character in a video with a person from an image. It preserves the scene, lighting, actions, and expressions for seamless integration.

Service modes

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

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

Authorizations

string

header

required

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

Header Parameters

enum<string>

required

Must be set to enable for asynchronous task submission. Returns a "current user api does not support synchronous calls" error if not included.

Available options:enable

Body

application/json

enum<string>

required

The model name.

Available options:wan2.2-animate-mix

Example:wan2.2-animate-mix

object

required

Basic input information.

Show child attributes

string

required

A publicly accessible HTTP or HTTPS link to the input character image. The URL cannot contain non-ASCII characters; encode the URL if it does. The image must show a single front-facing person with an unobstructed face, occupying a moderate portion of the frame.

Format: JPG, JPEG, PNG, BMP, or WEBP.
Resolution: Width and height must be within [200, 4096] pixels. Aspect ratio must be between 1:3 and 3:1.
File size: Up to 5 MB.

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

string

required

A publicly accessible HTTP or HTTPS link to the input reference video. The URL cannot contain non-ASCII characters; encode the URL if it does. The video must show a single front-facing person with an unobstructed face, occupying a moderate portion of the frame. Increasing the resolution and frame rate of the reference video improves the quality of the generated video.

Format: MP4, AVI, or MOV.
Resolution: Width and height must be within [200, 2048] pixels. Aspect ratio must be between 1:3 and 3:1.
File size: Up to 200 MB.
Duration: 2 to 30 seconds.

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

boolean

defaultfalse

Whether to add a "generated by qwen.ai" watermark in the lower-right corner of the video.

object

required

Generation parameters.

Show child attributes

enum<string>

required

The model service mode.

wan-std: Standard mode. Generates results faster and is cost-effective. Suitable for quick previews and basic animation scenarios.
wan-pro: Professional mode. Provides smoother animations and better effects, but processing time and costs increase accordingly.

Available options:wan-std,wan-pro

Example:wan-std

boolean

defaulttrue

Whether to perform image detection on the input image. true (default): the API detects the input image. false: image detection is skipped.

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

​Service modes

Authorizations

Header Parameters

Body

Response

Service modes