跳转到主要内容
GET
/
v1
/
videos
/
{task_id}
视频任务状态查询
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
}

授权

​
Authorization
string
header
必填

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

路径参数

​
task_id
string
必填

视频生成任务 ID。

响应

查询成功，返回任务状态。

​
id
string

视频生成任务 ID。

​
task_id
string

任务 ID（与 id 相同）。

​
object
string
示例:

"video"

​
model
string

使用的模型名称。

​
status
enum<string>

任务状态。queued: 排队中; running: 处理中; succeeded: 成功; failed: 失败; cancelled: 已取消; expired: 超时。

可用选项:
pending,
queued,
running,
succeeded,
failed,
cancelled,
expired
​
progress
integer

任务进度（百分比）。

必填范围: 0 <= x <= 100
​
created_at
integer<int64>

创建时间的 Unix 时间戳（秒）。

​
updated_at
integer<int64>

状态更新时间的 Unix 时间戳（秒）。

​
completed_at
integer<int64>

完成时间的 Unix 时间戳（秒），仅在成功或失败时返回。

​
video_url
string

生成视频的下载链接。有效期 24 小时，请及时保存。仅在状态为 succeeded 时返回。

​
last_frame_url
string

视频尾帧图像 URL。有效期 24 小时。仅当创建任务时 return_last_frame=true 时返回。

​
metadata
object

任务的详细元数据。