视频任务查询

约 421 字大约 1 分钟

火山视频生成是异步任务。创建接口返回 id 后，使用同一个 FrameAI API 地址查询任务，不要直接请求火山 Ark 域名。

查询接口

GET https://mivsub.com/v1/video/generations/task_01jvideo8f3x9
Authorization: Bearer sk-frameai-xxxxxxxx

将 URL 最后一段替换为创建任务返回的 id。如果 FrameAI API 配置的是火山原生兼容路由，则使用：

GET https://mivsub.com/api/v3/contents/generations/tasks/task_01jvideo8f3x9
Authorization: Bearer sk-frameai-xxxxxxxx

两种路径不能混用：通用路径对应 FrameAI 的统一视频接口，原生路径对应火山 Ark 任务格式。

处理中响应

{
  "id": "task_01jvideo8f3x9",
  "status": "processing"
}

完成响应

{
  "id": "task_01jvideo8f3x9",
  "status": "succeeded",
  "content": {
    "video_url": "https://cdn.example.com/output/task_01jvideo8f3x9.mp4"
  }
}

常见状态

状态	含义	处理方式
`queued`	已创建，等待上游处理。	继续轮询。
`processing`	上游正在生成。	继续轮询。
`succeeded`	生成完成。	读取 `content.video_url`。
`failed`	生成失败。	读取错误字段并结合常见问题错误处理。
`cancelled`	任务已取消。	记录原因后重新创建任务。

轮询示例

FRAMEAI_BASE="https://mivsub.com"
FRAMEAI_KEY="sk-frameai-xxxxxxxx"
TASK_ID="task_01jvideo8f3x9"

curl "$FRAMEAI_BASE/v1/video/generations/$TASK_ID" \
  -H "Authorization: Bearer $FRAMEAI_KEY"

建议间隔 3 至 10 秒查询一次，并设置最大等待时间。不要高频并发查询同一个任务，也不要在视频尚未完成时反复创建相同任务。

结果地址：上游返回的临时视频 URL 可能会过期。业务侧拿到 succeeded 后应尽快下载或转存，实际保留时间以火山和 FrameAI 配置为准。