K4.5.4 Task 4.5

轮询、下载、本地存储——结果 29 天后过期

Batch 生命周期

  1. 提交 batch → 收到 batch ID
  2. 轮询状态端点直到 processing_status: ended
  3. results_url 下载结果
  4. 结果保留 29 天——之后永久删除

没有 webhook,没有 streaming。只能轮询。

过期率随 Batch 大小上升

过期请求是在 24 小时截止前未处理完的那些:

Batch 大小过期率
1,0000.5%
1,5008.7%

更小、更频繁的 batch 能降低过期率。对于 30 小时 SLA 配合 24 小时最大 batch 处理时间,每 4-6 小时提交一次,给最差情况加一轮恢复留出缓冲。

本地存储结果

API 保留期(29 天)是固定的,不可配置。超过 29 天还没取结果意味着数据永久丢失。完成后立即下载,任何需要更长保留的场景都存到你自己的基础设施上。

取消

运行中的 batch 可以通过 POST 到取消端点来取消。当早期结果暴露出系统性的 prompt 错误时用这个——在整个 batch 以同样的问题跑完之前取消。


一句话总结: 轮询直到结束,立即下载,本地存储——结果 29 天过期,较大的 batch 过期率更高,所以提交更小更频繁的 batch。