Skip to main content
GET
/
kyyReactApiServer
/
v1
/
result
/
{id}
curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd \
  --header 'Authorization: Bearer {{key}}'

{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "Video",
  "created": 1774836724,
  "model": "viduq3-pro",
  "status": "processing",
  "video_url": null,
  "totalTokens": null,
  "error": null
}

​
Vidu Query Video Task

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

​
Authentication

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

​
Path Parameters

​
id
string
required
Unique identifier for the video generation task, returned from the create task interface

​
Response Parameters

​
id
string
Unique identifier for the video generation task
​
object
string
Object type, fixed as Video
​
created
integer
Task creation timestamp
​
model
string
Model name used
​
status
string
Task status:
  • queued - Queued
  • processing - Processing
  • completed - Completed
  • failed - Failed
​
video_url
string
Generated video URL, returned when status is completed
​
actualDuration
number
Actual video output duration in seconds, returned when status is completed
​
totalTokens
number
Total tokens consumed by the task
​
error
string
Error message, returned when status is failed

​
Status Flow

1

queued

Task created and added to queue, waiting for processing
2

processing

Task is being processed, Vidu model is generating the video
3

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 priorityEstimated generation time: 2-4 minutes

Vidu Q3 Pro

Quality priorityEstimated generation time: 3-6 minutes
curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd \
  --header 'Authorization: Bearer {{key}}'

{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "Video",
  "created": 1774836724,
  "model": "viduq3-pro",
  "status": "processing",
  "video_url": null,
  "totalTokens": null,
  "error": null
}