Skip to main content
GET
/
video
/
task
/
{taskId}
查询视频任务
curl --request GET \
  --url https://api.example.com/video/task/{taskId}
{
  "taskId": "<string>",
  "status": "<string>",
  "prompt": "<string>",
  "duration": 123,
  "ratio": "<string>",
  "videoUrl": "<string>",
  "thumbUrl": "<string>",
  "width": 123,
  "height": 123,
  "errorMessage": "<string>"
}

​
概述

查询视频生成任务的当前状态。已完成的任务会返回视频和缩略图的 Signed URL。

​
请求

​
taskId
string
required
视频任务 ID (UUID)

​
响应

​
taskId
string
任务 ID
​
status
string
任务状态：pending | processing | completed | failed | insufficient_credits | insufficient_plan
​
prompt
string
视频生成提示词
​
duration
number
视频时长（秒）：5 或 10
​
ratio
string
宽高比：auto | 16:9 | 9:16 | 1:1
​
videoUrl
string
视频 Signed URL（仅 completed 状态）
​
thumbUrl
string
缩略图 Signed URL（仅 completed 状态）
​
width
number
视频宽度（仅 completed 状态）
​
height
number
视频高度（仅 completed 状态）
​
errorMessage
string
错误信息（仅 failed 状态）

​
状态说明

状态说明用户操作
pending等待处理等待
processing正在生成等待
completed生成完成播放/下载
failed生成失败查看错误信息
insufficient_creditsCredits 不足充值后重新提交
insufficient_plan方案不支持升级方案后重新提交
前端通常不需要主动轮询此接口，视频状态变更会通过 Centrifugo WebSocket 实时推送。