Wan — Retrieve character swap result

Check face swap status

GET

/tasks/{task_id}

cURL - Query task result

# Replace {task_id} with the actual task ID from the submit response
curl -X GET 'https://dashscope-intl.aliyuncs.com/api/v1/tasks/{task_id}' \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"

{
  "request_id": "c1209113-8437-424f-a386-xxxxxx",
  "output": {
    "task_id": "966cebcd-dedc-4962-af88-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-03-25 01:36:21.497",
    "scheduled_time": "2026-03-25 01:36:30.247",
    "end_time": "2026-03-25 01:37:31.910",
    "results": {
      "video_url": "https://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxx.mp4?Expires=xxxxxx"
    }
  },
  "usage": {
    "video_duration": 5.2,
    "video_ratio": "standard"
  }
}

Check the status and get the result of a video character swap task.

How to poll

Create a task to get a task_id.
Poll this endpoint every 15 seconds until task_status is SUCCEEDED or FAILED.
On success, download the video from the video_url field.

Status flow and URL expiration

Status flow: PENDING → RUNNING → SUCCEEDED or FAILED.
URL expiration: video_url expires after 24 hours. Download the video promptly.

Authorizations

string

header

required

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

Path Parameters

string

required

The ID of the task to query.

Response

200-application/json

string

Unique request identifier for tracing and troubleshooting.

Example:a67f8716-18ef-447c-a286-xxxxxx

object

Task output information.

Show child attributes

string

The ID of the task. Valid for 24 hours.

Example:0385dc79-5ff8-4d82-bcb6-xxxxxx

enum<string>

The status of the task.

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

string

The time when the task was submitted. UTC+8. Format: YYYY-MM-DD HH:mm:ss.SSS.

Example:2025-09-18 15:32:00.105

string

The time when the task started running. UTC+8. Format: YYYY-MM-DD HH:mm:ss.SSS.

Example:2025-09-18 15:32:15.066

string

The time when the task completed. UTC+8. Format: YYYY-MM-DD HH:mm:ss.SSS.

Example:2025-09-18 15:34:41.898

object

Task results. Only present when task_status is SUCCEEDED.

Show child attributes

string

The URL of the generated video in MP4 format (H.264 encoding). Valid for 24 hours. Download promptly.

Example:http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/xxxxx.mp4?Expires=xxxxxx

string

Error code. Returned only when the task fails.

string

Detailed error message. Returned only when the task fails.

object

Usage statistics. Returned only for successful results.

Show child attributes

number

Duration of the generated video, in seconds.

Example:5.2

enum<string>

The model service mode used. standard corresponds to wan-std; pro corresponds to wan-pro.

Available options:standard,pro

​How to poll

​Status flow and URL expiration

Authorizations

Path Parameters

Response

How to poll

Status flow and URL expiration