Get Video Generation Task Status

Query Vidu video task status by task_id: fetch progress, video download URL, cover image, speech and sound tracks, and consumed credits, with URL expiry tips.

(Vidu Video)

Query the detailed status of a Vidu video generation task by task ID. Once the task completes, you can retrieve the video download link, cover image, audio track links, and consumed quota here.

📌 Basics

Endpoint: GET /v1/video/generations/{task_id}
Authentication: Bearer Token (Authorization: Bearer {{YOUR_API_KEY}})
Content type: application/json

📥 Request Parameters (Path)

Parameter	Type	Required	Description
task_id	`string`	Yes	The `task_id` returned when the task was created.

📤 Response

Status code: 200 OK

Field	Type	Description
code	`string`	Response status code (e.g. `success`).
data	`object`	Core task detail data.
├─ status	`string`	Overall task status: `QUEUED`, `PROCESSING`, `SUCCESS`, `FAILED`.
├─ progress	`string`	Human-readable progress percentage (e.g. "100%").
├─ result_url	`string`	Video download link (the final generated MP4 link).
├─ submit_time	`integer`	Task submission timestamp.
├─ finish_time	`integer`	Task completion timestamp.
└─ data (nested)	`object`	Video metadata details.
└─ creations	`array`	List of generated outputs.
└─ cover_url	`string`	Video cover image link.
└─ speech_url	`string`	Link to the generated speech/dialogue track (if audio is enabled).
└─ sound_url	`string`	Link to the generated background sound effects.

📝 Request Example (cURL)

curl -X GET "https://api.your-server.com/v1/video/generations/task_LK8YADXPxyoGME6wv79x8qId62v76PO5" \
 -H "Authorization: Bearer $YOUR_API_KEY"

📝 Response Example (Task Completed)

{
"code": "success",
"message": "",
"data": {
"task_id": "task_LK8YADXPxyoGME6wv79x8qId62v76PO5",
"status": "SUCCESS",
"progress": "100%",
"result_url": "https://cdn.vidu.com/video.mp4?auth_key=...",
"submit_time": 1774597865,
"finish_time": 1774598074,
"properties": {
"upstream_model_name": "viduq3-turbo"
},
"data": {
"aspect_ratio": "16:9",
"resolution": "1080p",
"creations": [
{
"id": "935021721856000000",
"url": "https://cdn.vidu.com/video.mp4",
"cover_url": "https://cdn.vidu.com/cover.jpeg"
}
],
"credits": 98
}
}
}

💡 Developer Tips

Link expiration: The returned result_url and cover_url usually carry AWS S3 presigned parameters (X-Amz-Signature) and expire (typically after 24 hours). Copy the files to your own storage as soon as the task succeeds.
Multiple audio tracks: If you enabled audio when creating the task, use speech_url and sound_url to fetch the pure speech track and pure sound-effects track separately for post-production editing.
Progress display: The data.progress field can be used directly for a frontend progress bar; it reflects the real-time progress of backend GPU rendering.
Credits accounting: The data.data.credits field records the actual system quota consumed by this video generation, which you can use for reconciliation in your billing system.