切换主题
视频任务与轮询
任务提交
统一入口:
text
POST /v1/videos创建成功后通常会返回下列字段之一:
idtask_idvideo_id
任务轮询
轮询接口:
text
GET /v1/videos/{id}推荐轮询策略
- 前几次可采用
10s -> 25s -> 25s - 之后固定
10s - 更高实时性场景可调整到
2s~10s
最大等待时长
- 普通任务:
300s~600s - Pro 或高耗时模型:
600s~1200s
兼容状态值
text
queued | pending | in_progress | processing | running |
completed | succeeded | done | failed | error | canceled | cancelledprogress 可能缺失,不应作为唯一判断依据。
结果获取
任务完成后,按兼容顺序尝试:
video_urldata.video_urlcontent.video_urlcontent.urldetail.video_url
注意事项
- 先检查输入图片 URL 是否公网可访问
- 不要把轮询间隔设得过短
- 获取到最终 URL 后,建议尽快转存到自有存储