查询视频任务

查询通过生成视频提交的视频生成任务的状态和结果。

#路径参数

参数	类型	说明
`task_id`	string	POST /v1/video/generations 返回的 task_id

#请求示例

terminalbash

curl https://relaydance.com/v1/video/generations/task_abc123 \
  -H "Authorization: Bearer $RELAYDANCE_API_KEY"

#响应

response.jsonjson

{
  "task_id": "task_abc123",
  "status": "succeeded",
  "url": "https://...mp4",
  "format": "mp4",
  "metadata": { "ratio": "16:9", "resolution": "1080p" }
}

#响应字段

字段	类型	说明
`task_id`	string	任务标识符
`status`	string	submitted \| running \| succeeded \| failed
`url`	string	视频的下载地址（status 为 succeeded 时存在）
`format`	string	输出封装格式，mp4
`metadata`	object	回显该任务的厂商参数

#状态值

状态	含义
`submitted`	任务已接受并进入队列
`running`	正在生成中
`succeeded`	已完成：从 url 下载视频
`failed`	生成失败；失败的任务不计费

每隔几秒轮询一次，直到状态变为 succeeded 或 failed。

#Webhook 替代方案

如果提交任务时设置了 metadata.callback_url，当任务进入最终状态时，会把同样的任务 JSON POST 到该地址，投递失败时还会重试。这种情况下无需轮询。详见视频生成。

←生成视频生成图像→