Wan — Retrieve first-last-frame 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
  }
}

Get task status and results for an image-to-video (first & last frames) generation task.

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.
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

The ID of the task to query.

Response

200-application/json

string

Unique request identifier for tracing and troubleshooting.

Example:ec016349-6b14-9ad6-8009-xxxxxx

object

Task output information.

Show child attributes

string

The ID of the task.

Example:3f21a745-9f4b-4588-b643-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-04-18 10:36:58.394

string

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

Example:2025-04-18 10:37:13.802

string

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

Example:2025-04-18 10:45:23.004

string

URL of the generated video (MP4, H.264). Returned only when task_status is SUCCEEDED. Valid for 24 hours.

Example:https://dashscope-result-wlcb.oss-cn-wulanchabu.aliyuncs.com/xxx.mp4?xxxxx

string

The original input prompt.

string

The optimized prompt used when prompt rewriting is enabled. Not returned when prompt rewriting is disabled.

string

Error code. Returned only when the task fails.

string

Detailed error message. Returned only when the task fails.

object

Usage statistics. Only returned for successful tasks.

Show child attributes

integer

Video duration in seconds. Value: 5. Billing formula: Cost = Video duration (seconds) x Unit price.

Example:5

integer

Number of videos generated. Fixed at 1.

Example:1

string

Video aspect ratio. Returned only by wan2.1 models. Fixed at standard.

Example:standard

enum<integer>

Video resolution tier. Returned only by wan2.2 models. Values: 480, 720, or 1080.

Available options:480,720,1080

Example:480

​Polling strategy

​Important notes

Authorizations

Path Parameters

Response

Polling strategy

Important notes