视频生成
如何通过 Yeehoo 对外 API 提交视频任务,并结合轮询或 webhook 获取终态。
视频生成和图片生成一样,也是异步任务模型,但通常执行时间更长。
适用场景
- 文生视频
- 营销短视频素材
- 批量视频任务调度
- 需要服务端回调通知的长任务流程
典型流程
- 调用
/v1/generations,并通过model指定视频模型 - 获取
task_id - 周期性调用
/v1/tasks/{task_id} - 进入终态后读取结果,或由 webhook 接收终态通知
推荐轮询策略
因为视频任务通常更慢,建议:
- 前 30 秒:每 3 到 5 秒轮询一次
- 更长任务:每 5 到 10 秒轮询一次
- 收到 webhook 后,仍然建议用一次任务查询做结果校验
接入建议
对视频任务更推荐尽早接入 webhook,因为:
- 任务时长更不稳定
- 纯轮询成本更高
- 更适合服务端异步编排
常见注意点
- 不要把视频任务当成同步请求处理
- 任务进入
running很正常,不代表异常 - 接收端要能处理失败终态,而不是只处理成功