返回知识库

数据与服务 · 运行与可靠性

异步任务与轮询Async Jobs & Polling

沿同一任务编号查询进度,直到产物托盘真正出现文件。

从受理单找到真正的产物

生成一段模拟课程片头:先提交,再用同一编号查询两次。每次查询代表一个采样时刻,不模拟真实等待。

任务单 · 未创建

下一步:提交任务,先拿受理凭证。

{}

产物托盘

空:只有任务编号,没有可打开文件。

知识点:查询不等于重做

受理回复说明任务存在;状态查询读取该任务的进度。HTTP 请求成功也可能只返回 processing。不要把轮询写成反复提交生成,否则可能重复扣费。真实服务还可能返回 failed 或 canceled,此时停止轮询并显示原因。

什么时候用、怎么用

适用于长时间生成、导出和转码。保存 task_id → 按服务约定的间隔查询 → 根据状态继续、停止或打开结果。尊重 Retry-After,设置超时、取消和退避;网页关掉不代表任务自动停止。短请求无需额外造任务系统。

正反例:同一段课程片头

正例:断网后继续查询原编号,取回原任务结果。

反例:断网就再次点生成,得到新编号,旧任务仍执行,产生重复任务。

快速自测

查询返回 200,status=processing,没有 result_url,应做什么?

继续查证

术语的技术定义和行为以这些一手或权威资料为准。

下一步学