HappyHorse -- Retrieve image-to-video 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": "8ae698ba-df2d-966c-abcf-xxxxxx",
  "output": {
    "task_id": "e56d806f-76f9-4037-aefa-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-04-20 19:33:50.425",
    "scheduled_time": "2026-04-20 19:33:50.463",
    "end_time": "2026-04-20 19:35:34.216",
    "orig_prompt": "A cat running on the grass",
    "video_url": "https://dashscope-result-sh.oss-accelerate.aliyuncs.com/xxx.mp4?Expires=xxx"
  },
  "usage": {
    "duration": 5,
    "input_video_duration": 0,
    "output_video_duration": 5,
    "video_count": 1,
    "SR": 720
  }
}

Poll task status and download the video when ready.

Polling strategy

Save the task_id from the submit response.
Poll this endpoint every 15 seconds until task_status is SUCCEEDED or FAILED.
Download the video from video_url within 24 hours -- the URL expires after that.

Authorizations

string

header

required

DashScope API Key. Get one from the QwenCloud console.

Path Parameters

string

required

Task ID from the POST response.

Response

200-application/json

string

Request ID for troubleshooting. Include this when contacting support.

Example:8ae698ba-df2d-966c-abcf-xxxxxx

object

Show child attributes

string

Task ID. Queryable for 24 hours after submission.

Example:e56d806f-76f9-4037-aefa-xxxxxx

enum<string>

Task lifecycle: PENDING -> RUNNING -> SUCCEEDED or FAILED. CANCELED if manually stopped. UNKNOWN if expired.

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

string

When the task was submitted (UTC+8, YYYY-MM-DD HH:mm:ss.SSS).

string

When the task started executing (UTC+8, YYYY-MM-DD HH:mm:ss.SSS).

string

When the task finished (UTC+8). Only present for SUCCEEDED or FAILED tasks.

string

Your original prompt text.

string

URL of the generated video (MP4, H.264, 24fps). 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

Resource consumption. Only present when task_status is SUCCEEDED.

Show child attributes

number

Billable video duration in seconds.

integer

Always 0 for image-to-video (no input video).

integer

Output video duration in seconds.

integer

Number of videos generated. Always 1.

integer

Resolution tier used (e.g., 720 for 720P, 1080 for 1080P).

​Polling strategy

Authorizations

Path Parameters

Response

Polling strategy