获取视频生成任务状态

GET https://open.feiyutoken.com/v1/video/generations/{task_id}

请求参数

参数	类型	必填	说明
task_id	string	是	路径参数，创建视频生成任务 返回的任务 ID

请求示例

curl https://open.feiyutoken.com/v1/video/generations/<task_id> \
  -H "Authorization: Bearer <你的飞鱼Token API Key>"

任务状态

状态	含义	是否终态
queued	排队中，还没开始生成	否
in_progress	生成中	否
completed	已完成，响应里带视频地址	是
failed	失败，响应里带错误信息	是

响应

{
  "task_id": "<task_id>",
  "status": "completed",
  "url": "<视频资源地址>",
  "format": "mp4"
}

字段	说明
task_id	任务 ID
status	任务状态，取值见上一节
url	视频资源地址，completed 时才有
format	视频封装格式
metadata	这次任务实际使用的生成参数：时长、帧率、宽高、随机种子
error	失败原因，含 code 与 message，failed 时才有

task_id 找不到时返回 404。

轮询建议

completed 与 failed 是终态，出现了就不要再查。中间态按自己的节奏轮询就好， 不要太密：视频生成本身是长任务，查得再勤也不会更快。