Vidu: Query Video Generation Task Status and Result

Use this endpoint to check the status of a Vidu video generation task and retrieve the result once it completes. Video generation is asynchronous — you should poll this endpoint periodically after submitting a task via Create Video Task until the status reaches completed or failed.

Endpoint

GET /v1/result/{id}

Authentication

Authorization: Bearer YOUR_API_KEY

Path Parameters

string

required

The unique task identifier returned by the Create Video Task endpoint in the id field.

Response Fields

string

The unique task identifier.

string

Object type. Always "Video".

integer

Unix timestamp of when the task was created.

string

The model used for this task (e.g. viduq3-pro or viduq3-turbo).

string

Current task status:

queued — task is waiting in the processing queue
processing — the model is actively generating the video
completed — generation finished; video_url is populated
failed — generation failed; see error for details

string

Direct download URL for the generated video (MP4 format). Only present when status is "completed". null while processing.

number

Actual output duration of the generated video in seconds. Only present when status is "completed".

number

Total token count consumed by this task. Populated after completion.

string

Error message describing the reason for failure. Only present when status is "failed".

Task Status Flow

The task moves through the following states: queued → processing → completed or failed

Status	Meaning
`queued`	Task accepted and waiting to be picked up by the model
`processing`	Vidu model is actively generating the video
`completed`	Generation succeeded — retrieve the video via `video_url`
`failed`	Generation encountered an error — check the `error` field

Polling Advice

Recommended polling interval: 30–60 seconds.Estimated generation times by model:

viduq3-turbo — typically 2–4 minutes
viduq3-pro — typically 3–6 minutes

Stop polling as soon as status is completed or failed. Polling too frequently may trigger rate limiting.

Video URL Notes

Generated video URLs are valid for 24 hours only. Download and store the video file in your own storage system as soon as generation completes — the URL will become inaccessible after expiry.

Videos are delivered in MP4 format
The URL is a direct download link — no additional authentication required

Code Examples

curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd \
  --header 'Authorization: Bearer YOUR_API_KEY'

import requests
import time

task_id = "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd"
headers = {"Authorization": "Bearer YOUR_API_KEY"}

while True:
    response = requests.get(
        f"https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/{task_id}",
        headers=headers,
    )
    result = response.json()
    status = result["status"]

    print(f"Status: {status}")

    if status == "completed":
        print("Video URL:", result["video_url"])
        print("Duration:", result["actualDuration"], "seconds")
        break
    elif status == "failed":
        print("Error:", result["error"])
        break

    time.sleep(30)  # Wait 30 seconds before next poll

Example Responses

While processing:

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

On completion:

{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "Video",
  "created": 1774836724,
  "model": "viduq3-pro",
  "status": "completed",
  "video_url": "https://cdn.example.com/video_fd35ee52.mp4",
  "actualDuration": 5,
  "totalTokens": 1500,
  "error": null
}

On failure:

{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "Video",
  "created": 1774836724,
  "model": "viduq3-pro",
  "status": "failed",
  "video_url": null,
  "totalTokens": null,
  "error": "Content policy violation: prompt contains restricted content."
}

Overview

Text APIs

Image APIs

Video APIs

Asset Management

Vidu: Query Video Generation Task Status and Result

Endpoint

Authentication

Path Parameters

Response Fields

Task Status Flow

Polling Advice

Video URL Notes

Code Examples

Example Responses

​Endpoint

​Authentication

​Path Parameters

​Response Fields

​Task Status Flow

​Polling Advice

​Video URL Notes

​Code Examples

​Example Responses

Endpoint

Authentication

Path Parameters

Response Fields

Task Status Flow

Polling Advice

Video URL Notes

Code Examples

Example Responses