Wan — Retrieve the digital human video result

Check the status of a digital human video task and download the video

GET

/tasks/{task_id}

cURL

# China North 2 (Beijing). This model is available only in this region.
# API keys are region-specific. See https://docs.qwencloud.com/developer-guides/getting-started/regions
curl --request GET \
  --url https://cn-beijing.maas.qwencloudapi.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
  "output": {
    "task_id": "bcae8761-f242-4775-a11e-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2025-09-01 09:37:27.468",
    "scheduled_time": "2025-09-01 09:37:34.885",
    "end_time": "2025-09-01 09:40:20.734",
    "results": {
      "video_url": "http://dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com/1d/xxx.mp4?Expires=xxxxxx"
    }
  },
  "usage": {
    "duration": 18.13,
    "size": "512*640",
    "fps": 16,
    "video_count": 1,
    "SR": 480
  },
  "request_id": "28cfedb1-cd60-9e0c-b920-xxxxxx"
}

Polling strategy

Call Create a digital human video to get a task_id.
Poll this endpoint every 15 seconds until task_status is SUCCEEDED or FAILED. Video generation takes about 5 to 10 minutes.
On success, download the video from the video_url field.

Notes

URL expiration: The video_url expires after 24 hours. Download it promptly.
Task ID expiration: A task_id is valid for 24 hours. After that, you cannot query its status or result.
Task status flow: PENDING → RUNNING → SUCCEEDED or FAILED. CANCELED means the task was canceled. UNKNOWN means the task ID is invalid or expired.
Avoid duplicate submissions: Poll for the result instead of submitting the task again.

Authorizations

string

header

required

QwenCloud API key. See Get an API key.

Path Parameters

string

required

The task ID to query.

Response

200-application/json

object

Show child attributes

string

The queried task ID.

Example:a8532587-fa8c-4ef8-82be-0c46b17950d1

enum<string>

Task status. Possible values: PENDING (queued), RUNNING (processing), SUCCEEDED, FAILED, UNKNOWN (task does not exist or status is unknown), CANCELED (task canceled).

Available options:PENDING,RUNNING,SUCCEEDED,FAILED,UNKNOWN,CANCELED

Example:SUCCEEDED

string

Time the task was submitted.

Example:2025-09-01 09:37:27.468

string

Time the task started running.

Example:2025-09-01 09:37:34.885

string

Time the task completed.

Example:2025-09-01 09:40:20.734

object

Show child attributes

string

URL of the generated video. The URL expires after 24 hours. Download it promptly.

Example:https://example.com/1.mp4?Expires=xxx

string

Error code. Returned when the task fails.

Example:InvalidParameter

string

Error details. Returned when the task fails.

Example:The request is missing required parameters or in a wrong format

object

Show child attributes

number

Video duration in seconds. Billing is per second.

Example:10.23

integer

Number of generated videos.

Example:1

integer

Output resolution tier.

Example:480

string

Resolution of the generated video.

Example:640*480

integer

Frame rate of the generated video.

Example:16

string

Unique ID of this request.

Example:7574ee8f-38a3-4b1e-9280-11c33ab46e51

​Polling strategy

​Notes

Authorizations

Path Parameters

Response

Polling strategy

Notes