Volcengine Query Video Generation Task

GET /api/v3/contents/generations/tasks/{task_id}

Query the status and result of a video generation task submitted via Volcengine Create Video Generation Task. Once the task succeeds, the generated video URL can be retrieved from the response.

⚠️ The task ID is retained for only 7 days (from the task creation time) and is automatically cleared afterward.

Request Parameters

Name	Type	Required	Description
task_id (path)	string	Required	Video generation task ID

Request Example

{
  "path": {
    "task_id": "cgt-2026xxxx-xxxxx"
  }
}

Response Fields (200)

Name	Type	Description
id	string	Video generation task ID
task_id	string	Video generation task ID (same as id)
object	string	Object type, always video
model	string	Model name
status	string	Task status: queued, in_progress, completed, failed
progress	integer	Task progress percentage (0–100)
created_at	integer	Task creation timestamp (seconds)
completed_at	integer	Task completion timestamp (seconds)
metadata	object	Video task metadata
metadata.url	string	Generated video URL (when succeeded)
error	object	Task error info (when failed)
error.code	string	Error code
error.message	string	Error message

Response Example

{
  "id": "cgt-2026xxxx-xxxxx",
  "task_id": "cgt-2026xxxx-xxxxx",
  "object": "video",
  "model": "doubao-seedance-1-5-pro-251215",
  "status": "completed",
  "progress": 100,
  "created_at": 1757222400,
  "completed_at": 1757222520,
  "metadata": {
    "url": "https://example.com/generated-video.mp4"
  }
}