Skip to main content
Qwen Cloud home page
Docs
Reference-to-video

Wan — Retrieve reference-to-video result

Check video task 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",
    "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 URL.

Polling strategy

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

Important notes

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

Authorizations

​
string
header
required

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

Path Parameters

​
string
required

Task identifier returned by the video creation endpoint.

Response

200-application/json
​
string

Unique request identifier.

​
object
​
object

Usage statistics (only present when task succeeds).