Alibaba Cloud Model Studio:Wan - image to animation API reference

Singapore: POST https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis

Beijing: POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis

Step 1: Create a task and get the task ID

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-move",
    "input": {
        "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/adsyrp/move_input_image.jpeg",
        "video_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250919/kaakcn/move_input_video.mp4"
    },
    "parameters": {
        "mode": "wan-std"
    }
  }'

Step 2: Query the result by task ID

curl -X GET https://dashscope-intl.aliyuncs.com/api/v1/tasks/0385dc79-5ff8-4d82-bcb6-xxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
    "request_id": "a67f8716-18ef-447c-a286-xxxxxx",
    "output": {
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-09-18 15:32:00.105",
        "scheduled_time": "2025-09-18 15:32:15.066",
        "end_time": "2025-09-18 15:34:41.898",
        "results": {
            "video_url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxx.mp4?Expires=xxxxxx"
        }
    },
    "usage": {
        "video_duration": 5.2,
        "video_ratio": "standard"
    }
}

{
    "request_id": "daad9007-6acd-9fb3-a6bc-xxxxxx",
    "output": {
        "task_id": "fe8aa114-d9f1-4f76-b598-xxxxxx",
        "task_status": "FAILED",
        "code": "InternalError",
        "message": "xxxxxx"
    }
}

wan2.2-animate-move offers two service modes, standard mode (wan-std) and professional mode (wan-pro), to meet the needs for image-to-animation effects in different scenarios.

Billing rules

• Billing method: This service uses the pay-as-you-go billing method. You are charged based on the duration (in seconds) of the successfully generated video. The billable duration is the value of the usage.video_duration field in the response for a successful task.

  Click to view a billing example

  Fees are calculated after the free quota is exhausted. The formula is: Total cost = Actual video duration (in seconds) × Unit price of the selected service mode.

  Assume that you call a model in the Singapore region to generate a video, the usage.video_duration returned for the successful task is 5.2 seconds, and you selected the standard mode (wan-std).

  The cost is calculated as follows: 5.2 seconds × $0.12/second = $0.624.

  Note: The final billable duration is the value of the usage.video_duration field in the response for a successful task.

• Offset order: The free quota is applied first. After the free quota is exhausted, the pay-as-you-go method is used by default. You can enable the Free quota only feature to prevent extra charges after your free quota is exhausted. For more information, see Free quota for new users.

• No charge for failed calls: If a model call fails or a processing error occurs, no fees are charged, and your free quota is not consumed.

Rate limiting: The total request frequency limit for an Alibaba Cloud account and its RAM users is 5 requests per second. A maximum of 1 task can be processed at a time. New tasks that exceed this limit are added to a queue. For more information about model throttling rules and FAQs, see Rate limits.

Q: How can I view model usage?

A: Model calling information is subject to an hourly delay. About one hour after a model is called, you can go to the Model Observation (Singapore or Beijing) page to view metrics such as call volume, number of calls, and success rate. For more information, see How do I view model call records?

Q: How can I optimize the quality of the generated video?

A: Consider the following recommendations:

1. Make sure the person occupies a similar portion of the frame in both the input image and the reference video.

2. Try to keep the body proportions of the person consistent between the image and the video.

3. Use high-definition source materials. Avoid blurry images or low-frame-rate videos to ensure accurate detail recognition.

Q: How can I convert a temporary video link to a permanent one?

A: You cannot convert the link directly. The correct procedure is to have your backend service download the video file using the URL and then upload it to a permanent object storage service, such as Alibaba Cloud OSS, to generate a new, permanent access link.

import requests

def download_and_save_video(video_url, save_path):
    try:
        response = requests.get(video_url, stream=True, timeout=300) # Set timeout
        response.raise_for_status() # If the HTTP status code is not 200, raise an exception
        with open(save_path, 'wb') as f:
            for chunk in response.iter_content(chunk_size=8192):
                f.write(chunk)
        print(f"Video downloaded successfully to: {save_path}")
        # You can add the logic to upload to permanent storage here
    except requests.exceptions.RequestException as e:
        print(f"Failed to download video: {e}")

if __name__ == '__main__':
    video_url = "http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxxx"
    save_path = "video.mp4"
    download_and_save_video(video_url, save_path)

Q: Can the returned video link be played directly in a browser?

A: This is not recommended because the link expires after 24 hours. The best practice is to have your backend download and save the video, and then use a permanent link for playback.