DocsVideo Status
Video
GET /unified-video/:taskId/status
Look up progress for a video generation task when you need manual status checks or a fallback to callback delivery.
GET /unified-video/:taskId/statusScope: api.generate
Best for
Teams building history pages, task tracking, and result states.
Manual lookup
Fallback checks
Completion and failure states
How to call it
json
{
"model": "seedance-1.5-pro",
"prompt": "黃昏海邊的電影感鏡頭，光線柔和，海浪慢慢推進",
"aspectRatio": "16:9",
"resolution": "720p",
"duration": 8
}What this API is for
The main completion path should be callback or webhook delivery.
Use this endpoint when you need a manual check, recovery path, or fallback instead of treating polling as the default workflow.
Parameters
taskId
Required path parameter. The taskId returned by /unified-video/generate.
Response fields
success
Whether the lookup succeeded.
taskId
Current task id.
status
Current task status.
output / assets
Generated output when complete, if available.
error
Failure detail when the task fails.
Frontend notes
- Translate raw status values into customer-facing labels.
- Keep progress visible in the task history area when doing manual checks.
- On failure, show a clear explanation and allow retry from the original setup.
Ready to test with your own key?
Create a general API key in Settings, then come back here to copy a request example.