YeeHooDevelopers
开发者文档

视频生成

如何通过 Yeehoo 对外 API 提交视频任务,并结合轮询或 webhook 获取终态。

视频生成和图片生成一样,也是异步任务模型,但通常执行时间更长。

适用场景

  • 文生视频
  • 营销短视频素材
  • 批量视频任务调度
  • 需要服务端回调通知的长任务流程

典型流程

  1. 调用 /v1/generations,并通过 model 指定视频模型
  2. 获取 task_id
  3. 周期性调用 /v1/tasks/{task_id}
  4. 进入终态后读取结果,或由 webhook 接收终态通知

推荐轮询策略

因为视频任务通常更慢,建议:

  • 前 30 秒:每 3 到 5 秒轮询一次
  • 更长任务:每 5 到 10 秒轮询一次
  • 收到 webhook 后,仍然建议用一次任务查询做结果校验

接入建议

对视频任务更推荐尽早接入 webhook,因为:

  • 任务时长更不稳定
  • 纯轮询成本更高
  • 更适合服务端异步编排

常见注意点

  • 不要把视频任务当成同步请求处理
  • 任务进入 running 很正常,不代表异常
  • 接收端要能处理失败终态,而不是只处理成功

下一步

本页目录