Vidu reference-to-video — Query the result

GET

/tasks/{task_id}

Query the task result

# Singapore (ap-southeast-1). This model is available only in this region.
# API keys are region-specific. See https://docs.qwencloud.com/developer-guides/getting-started/regions
curl -X GET 'https://ap-southeast-1.maas.qwencloudapi.com/api/v1/tasks/{task_id}' \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY"

{
  "request_id": "3606f9f4-b833-44ec-8385-xxxxxx",
  "output": {
    "task_id": "2846881f-0496-4288-947f-xxxxxx",
    "task_status": "SUCCEEDED",
    "submit_time": "2026-03-27 14:25:32.057",
    "scheduled_time": "2026-03-27 14:25:32.084",
    "end_time": "2026-03-27 14:28:29.600",
    "orig_prompt": "The camera slowly pans up from below a sea turtle swimming leisurely.",
    "video_url": "https://example.com/generated-video.mp4"
  },
  "usage": {
    "duration": 5,
    "size": "1280*720",
    "output_video_duration": 5,
    "fps": 24,
    "audio": false,
    "SR": "720",
    "video_count": 1
  }
}

Polling strategy

Call Create a reference-to-video task to get a task_id.
Poll this endpoint every 5 seconds until task_status is SUCCEEDED or FAILED. Generation takes 1 to 5 minutes.
On success, download the video from output.video_url.

Notes

URL expiration: The video URL expires after 24 hours. Download the video promptly.
Task ID expiration: A task_id is valid for 24 hours. After that, the status is returned as UNKNOWN.
Task status flow: PENDING → RUNNING → SUCCEEDED or FAILED. CANCELED means the task was canceled.
Billing: Charged per second of output video. For viduq3-drama, the model may adjust the length to preserve story completeness, and billing uses the actual output duration.

Output

Field	Description
`output.video_url`	Download URL of the generated MP4 video. Valid for 24 hours.
`usage.duration`	Billable video duration in seconds.
`usage.output_video_duration`	Actual duration of the generated video.
`usage.size`	Output resolution in `width*height` format.
`usage.audio`	Whether the video contains audio.

Authorizations

string

header

required

QwenCloud API key. See Get an API key.

Path Parameters

string

required

The task ID returned by the create operation. It is valid for queries for 24 hours.

Response

200-application/json

string

Unique request identifier for tracing and troubleshooting.

object

Show child attributes

string

The task ID. It is valid for queries for 24 hours.

enum<string>

The task status. The status flow is PENDING → RUNNING → SUCCEEDED or FAILED. UNKNOWN means the task does not exist or has expired.

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

string

Task submission time in YYYY-MM-DD HH:mm:ss.SSS format.

string

Task start time in YYYY-MM-DD HH:mm:ss.SSS format.

string

Task completion time in YYYY-MM-DD HH:mm:ss.SSS format.

string

The prompt used for generation. Returned only when the task succeeds.

string

The URL of the generated MP4 video. The URL is valid for 24 hours. Download the video promptly.

string

Error code. Returned only when the task fails.

string

Detailed error message. Returned only when the task fails.

object

Output statistics. Returned only when the task succeeds.

Show child attributes

integer

The billable video duration in seconds.

string

The output resolution in width*height format.

integer

The actual duration of the generated video in seconds.

integer

The frame rate of the generated video. Fixed at 24.

boolean

Whether the generated video contains audio.

string

The vertical resolution of the generated video.

integer

The number of generated videos.

​Polling strategy

​Notes

​Output

Authorizations

Path Parameters

Response

Polling strategy

Notes

Output