Skip to main content
GET
/
v1
/
videos
/
{task_id}
Video Task Status
curl --request GET \
  --url https://api.powertokens.ai/v1/videos/{task_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "cgt-20250331175019-68d9t",
  "task_id": "cgt-20250331175019-68d9t",
  "object": "video",
  "model": "seedance-1-5-pro-251215",
  "status": "queued",
  "progress": 0,
  "created_at": 1742515200
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
task_id
string
required

Video generation task ID.

Response

Query successful, returns task status.

​
id
string

Video generation task ID.

​
task_id
string

Task ID (same as id).

​
object
string
Example:

"video"

​
model
string

Model name used.

​
status
enum<string>

Task status. queued: queuing; running: processing; succeeded: success; failed: failed; cancelled: cancelled; expired: timeout.

Available options:
pending,
queued,
running,
succeeded,
failed,
cancelled,
expired
​
progress
integer

Task progress (percentage).

Required range: 0 <= x <= 100
​
created_at
integer<int64>

Unix timestamp of creation time (seconds).

​
updated_at
integer<int64>

Unix timestamp of status update (seconds).

​
completed_at
integer<int64>

Unix timestamp of completion (seconds), returned only on success or failure.

​
video_url
string

Generated video download URL. Valid for 24 hours, please save promptly. Returned only when status is succeeded.

​
last_frame_url
string

Video last frame image URL. Valid for 24 hours. Returned only when return_last_frame=true was set during task creation.

​
metadata
object

Task detailed metadata.