获取视频任务进度

通过任务 ID 查询视频生成任务的实时状态，任务完成后响应中会返回视频下载地址。

一、接口信息

• 接口用途：查询视频生成任务状态和结果
• 请求方式：GET
• 请求地址：https://www.yunshukjai.com/v1/video/generations/{task_id}
• 鉴权方式：Authorization: Bearer YOUR_API_KEY

平台同时提供 OpenAI 兼容的查询接口 GET /v1/videos/{task_id}，返回字段和下面基本一致，可按需使用。

二、路径参数

参数	类型	必填	说明
task_id	string	是	创建视频时返回的任务 ID

三、请求示例

curl "https://www.yunshukjai.com/v1/video/generations/abcd1234efgh" \
  -H "Authorization: Bearer YOUR_API_KEY"

四、响应示例

{
  "id": "task_abc123def456",
  "task_id": "task_abc123def456",
  "object": "video",
  "model": "doubao-seedance-2-0-260128",
  "prompt": "宇航员在月球表面慢慢行走",
  "status": "completed",
  "seconds": "8",
  "size": "720x1280",
  "progress": 100,
  "video_url": "https://example.com/video.mp4",
  "created_at": 1774073651,
  "expires_at": 1774246817,
  "completed_at": 1774074017
}

响应字段说明

字段	类型	说明
id	string	任务 ID
task_id	string	任务 ID
model	string	使用的模型名称
status	string	任务状态（见下方状态说明）
progress	integer	生成进度百分比
video_url	string	视频下载地址（任务完成时返回）
seconds	string	视频时长（秒）
size	string	视频分辨率
created_at / completed_at	integer	创建时间 / 完成时间
expires_at	integer	视频下载地址过期时间
error	object	失败时的错误信息

状态说明

状态	说明
queued	已提交，排队中
in_progress / processing	生成中
completed / succeeded	已完成，可获取视频
failed	生成失败，查看 error 字段

不同接口版本的完成状态可能显示为 completed 或 succeeded，两者都表示任务已成功。

五、轮询建议

• 提交任务后先等待 2～3 秒再开始查询。
• 前 30 秒每 5 秒查询一次；30 秒到 2 分钟每 10 秒一次；2 分钟之后每 30 秒一次。
• 建议设置 5～10 分钟的总超时时间，避免无限等待。
• 查询到完成状态后，到获取视频内容下载视频。

相关文档

• 创建视频
• 获取视频内容