mingyanmingyan
wechatwechat
mingyan

Vidu - Query Task

Query the status and results of Vidu video generation tasks

GET/kyyReactApiServer/v1/result/{id}

Vidu Query Video Task

Use the task ID to query the status and results of Vidu video generation tasks.

Authentication

Get Key
All requests require a Bearer token in the request header:
cURL
Authorization: Bearer {{key}}

Base URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl is the shared prefix for all public APIs. The api field in the current page frontmatter shows the full endpoint. Use this baseUrl as the common prefix when reading or composing request paths.

Path Parameters

idstringrequired
Unique identifier for the video generation task, returned from the create task interface

Response Parameters

idstring
Unique identifier for the video generation task
objectstring
Object type, fixed as Video
createdinteger
Task creation timestamp
modelstring
Model name used
statusstring
Task status:
  • queued - Queued
  • processing - Processing
  • completed - Completed
  • failed - Failed
video_urlstring
Generated video URL, returned when status is completed
actualDurationnumber
Actual video output duration in seconds, returned when status is completed
totalTokensnumber
Total tokens consumed by the task
errorstring
Error message, returned when status is failed

Status Flow

queued

Task created and added to queue, waiting for processing

processing

Task is being processed, Vidu model is generating the video

completed

Task completed, video generated successfully, result available via video_url

Polling Recommendations

Polling Strategy:
  • Recommended polling interval: 30-60 seconds
  • Vidu generation speed varies by model:
    • viduq3-turbo: typically completes in 2-4 minutes
    • viduq3-pro: typically completes in 3-6 minutes
  • Avoid overly frequent requests to prevent rate limiting
  • Stop polling when status is completed or failed

Video URL Information

Important:
  • Generated video URLs typically expire after 24 hours
  • Please download and save videos to your storage system promptly
  • URLs will be inaccessible after expiration
  • Video files are typically in MP4 format

Generation Time Estimates

Vidu Q3 Turbo

Speed priority
Estimated generation time: 2-4 minutes

Vidu Q3 Pro

Quality priority
Estimated generation time: 3-6 minutes