Wanxiang - Digital Human

Updated at:

The wan2.2-s2v digital human model generates natural-looking speaking, singing, or performing videos from a single image and an audio file . It supports any aspect ratio and works with portrait, full-body, or half-body images.

ImportantThis document applies only to the China (Beijing) region. Use an API key from this region.

Model overview

Example output
Input exampleOutput video
input_imageInput audio

To generate a digital human video, follow these steps:

  • Step 1: Call the wan2.2-s2v-detect API with the image URL to verify compliance.
  • Step 2: If the image passes validation, call the asynchronous wan2.2-s2v API with the image URL and audio URL to submit the video generation task. Then poll for the result.

Getting Started

Prerequisites

Before calling the API, enable the model service and obtain an API key. Then set the API key as an environment variable.

Sample code

The sample image in this topic has already passed image detection. The following shows sample code for video generation.

NoteHTTP requests occur in two steps: first create a task, then retrieve the result. Beginners should use Postman to call the API.

Step 1: Create a task and get the task ID

This request returns a task_id that you can use to query the result.

curl 'https://dashscope.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-s2v",
     "input": {
            "image_url": "https://img.alicdn.com/imgextra/i3/O1CN011FObkp1T7Ttowoq4F_!!6000000002335-0-tps-1440-1797.jpg",
            "audio_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250825/iaqpio/input_audio.MP3"
        },
        "parameters": {
            "style": "speech"
        }
    }'
Step 2: Query the result using the task ID

Replace 86ecf553-d340-4e21-xxxxxxxxx with your actual task_id.

If you use a model in the Singapore region, replace base_url with https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx, where {WorkspaceId} is your actual workspace ID.

curl -X GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

A task_id is valid for 24 hours. After it expires, queries fail and the API returns a status of UNKNOWN.

Next steps

Review the API documentation to start development based on your needs:

Image detection API

Video generation API