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

Wan — Retrieve text-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": 10
  }
}
Check task status and retrieve video results.

Polling strategy

  1. Submit a task via Generate a video from text and save the returned task_id.
  2. Poll every 15 seconds until task_status reaches SUCCEEDED or FAILED.
  3. On success, retrieve the video from video_url.

Notes

  • URL expiration: Download within 24 hours — video_url expires after that.
  • Status flow: PENDING → RUNNING → SUCCEEDED / FAILED.

Authorizations

​
string
header
required

DashScope API Key. Get one from the Qwen Cloud console.

Path Parameters

​
string
required

Task ID returned by the POST submission endpoint.

Response

200-application/json
​
string

Unique request identifier.

Example:c1209113-8437-424f-a386-xxxxxx
​
object
​
object

Usage statistics. Only present when task succeeds.