Wan 2.7 -- Retrieve reference-to-video result

Check Wan 2.7 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": "52cade0d-905e-9b7d-a01e-xxxxxx",
  "output": {
    "task_id": "18814247-f944-4102-aa4a-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-04-02 22:53:19.537",
    "scheduled_time": "2026-04-02 22:53:30.427",
    "end_time": "2026-04-02 23:00:39.287",
    "orig_prompt": "Video 2 holds Image 3 and plays a soothing American country ballad in a coffee shop, while Video 1 smiles, watches Video 2, and slowly walks towards him",
    "video_url": "https://dashscope-a717.oss-accelerate.aliyuncs.com/xxx.mp4?xxxx"
  },
  "usage": {
    "duration": 15,
    "input_video_duration": 5,
    "output_video_duration": 10,
    "video_count": 1,
    "SR": 720,
    "ratio": "16:9"
  }
}

Check task status and retrieve the generated video URL. The response includes timestamps and the original prompt for tracking.

Polling strategy

Create a task to receive a task_id.
Poll this endpoint every 15 seconds until task_status is SUCCEEDED or FAILED.
On success, download 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.
Enhanced metadata: The response includes submit_time, scheduled_time, end_time, and orig_prompt (the original prompt before any prompt extension).
Usage details: Billing is based on duration (= input_video_duration + output_video_duration). The response also returns SR (resolution) and ratio.

Authorizations

string

header

required

DashScope API Key. Create one in the QwenCloud console.

Path Parameters

string

required

Task identifier returned by the video creation endpoint.

Response

200-application/json

string

Unique request identifier.

object

Show child attributes

string

Task identifier.

enum<string>

Current task status.

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

string

Task submission time in UTC+8 format (e.g., 2026-04-02 22:53:19.537).

string

Task scheduling time in UTC+8 format.

string

Task completion time in UTC+8 format.

string

The original prompt before any prompt extension was applied.

string

Generated video URL (MP4, H.264 codec). Only present when task_status is SUCCEEDED. Valid for 24 hours — download promptly.

string

Error code. Only present when task_status is FAILED.

string

Error message. Only present when task_status is FAILED.

object

Usage statistics (only present when task succeeds).

Show child attributes

integer

Total billable duration in seconds (equals input_video_duration + output_video_duration).

integer

Duration of the input reference video(s) in seconds.

integer

Duration of the generated output video in seconds.

integer

Number of videos generated (always 1).

integer

Resolution of the generated video (e.g., 720 or 1080).

string

Aspect ratio of the generated video (e.g., 16:9).

​Polling strategy

​Important notes

Authorizations

Path Parameters

Response

Polling strategy

Important notes