视频任务状态查询

根据任务 ID 查询异步视频任务的最新状态。

状态流转通常为 queued -> running -> succeeded/failed/expired。当前仅支持查询最近 7 天内创建的任务。

GET /v1/videos/{task_id}

视频任务状态查询

cURL

curl --request GET \
  --url https://api.powertokens.ai/v1/videos/{task_id} \
  --header 'Authorization: Bearer <token>'

200

queued

{ "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。

响应

200

application/json

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

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

任务的详细元数据。

Show child attributes