Skip to main content
Video character swap

Wan — Swap video character

Submit face swap task

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:
ModeValueDescription
Standardwan-stdFaster and cheaper. Good for quick previews.
Professionalwan-proSmoother 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.

enable

Body

application/json
enum<string>
required

The model name.

wan2.2-animate-mix
wan2.2-animate-mix
object
required

Basic input information.

object
required

Generation parameters.

Response

200-application/json
string

Unique request identifier for tracing and troubleshooting.

4909100c-7b5a-9f92-bfe5-xxxxxx
object