Wan — Retrieve first-frame result

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",
    "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx",
    "task_metrics": {
      "TOTAL": 1,
      "SUCCEEDED": 1,
      "FAILED": 0
    }
  },
  "usage": {
    "video_count": 1,
    "video_duration": 5
  }
}

Check task status and retrieve the generated video.

Polling strategy

Create a task to receive a task_id.
Poll every 15 seconds until task_status is SUCCEEDED or FAILED.
On success, retrieve the video from video_url.

Important notes

URL expiration: Video URLs expire after 24 hours. Download promptly.
Status flow: PENDING → RUNNING → SUCCEEDED or FAILED.

Authorizations

string

header

required

DashScope API Key. Create one in the QwenCloud console.

Path Parameters

string

required

The task ID returned by the POST endpoint.

Response

200-application/json

string

Unique request identifier.

Example:2ca1c497-f9e0-449d-9a3f-xxxxxx

object

Show child attributes

string

The task ID.

Example:af6efbc0-4bef-4194-8246-xxxxxx

enum<string>

Current task status. Transitions: PENDING → RUNNING → SUCCEEDED or FAILED. UNKNOWN means the task does not exist or has expired.

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

string

Time when the task was submitted. UTC+8 format: YYYY-MM-DD HH:mm:ss.SSS.

Example:2025-09-25 11:07:28.590

string

Time when the task started running. UTC+8 format: YYYY-MM-DD HH:mm:ss.SSS.

Example:2025-09-25 11:07:35.349

string

Time when the task completed. UTC+8 format: YYYY-MM-DD HH:mm:ss.SSS.

Example:2025-09-25 11:17:11.650

string

URL of the generated video. Returned only when task_status is SUCCEEDED. Valid for 24 hours. Download promptly. MP4 format with H.264 encoding.

Example:https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.mp4?Expires=xxx

string

The original input prompt.

string

When prompt_extend=true, returns the optimized prompt used for generation. Not returned if prompt_extend=false. The wan2.6 model never returns this field.

string

Error code. Returned only when the task fails.

string

Detailed error message. Returned only when the task fails.

object

Output statistics. Returned only for successful tasks. Fields vary by model version.

Show child attributes

integer

Total video duration used for billing. For wan2.6 models: input_video_duration + output_video_duration.

integer

Duration of input video in seconds. Fixed at 0 for image-to-video. Returned by wan2.6 models.

integer

Duration of output video in seconds. Returned by wan2.6 models.

integer

Number of generated videos. Fixed at 1.

Example:1

integer

Resolution tier of the generated video (e.g., 720). Returned by wan2.6, wan2.5, and wan2.2 models.

Example:720

boolean

Whether the output video has sound. Returned by wan2.6-i2v-flash only.

integer

Duration of generated video in seconds. Returned by wan2.1 models only.

string

Aspect ratio of generated video. Fixed at standard. Returned by wan2.1 models only.

​Polling strategy

​Important notes

Authorizations

Path Parameters

Response

Polling strategy

Important notes