Skip to main content
QwenCloud home page
Docs
Vidu image-to-video

Vidu image-to-video — Query the result

Check the status of a Vidu image-to-video task and download the video

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

  1. Call Create an image-to-video task to get a task_id.
  2. Poll this endpoint every 5 seconds until task_status is SUCCEEDED or FAILED. Generation takes 1 to 5 minutes.
  3. 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.
  • Avoid duplicate submissions: Poll for the result instead of submitting the task again.
  • Billing: Charged per second of output video. duration and resolution directly affect the cost.

Output

FieldDescription
output.video_urlDownload URL of the generated MP4 video. Valid for 24 hours.
usage.durationBillable video duration in seconds.
usage.output_video_durationActual duration of the generated video.
usage.sizeOutput resolution in width*height format.
usage.fpsFrame rate of the generated video.

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
​
object

Output statistics. Returned only when the task succeeds.