Batch 结果是 JSONL 格式,每条请求有 result.type:succeeded、errored 或 expired。每条结果包含 custom_id 用于识别。
选择性重试
1,000 个请求中:940 成功,45 出错,15 过期。只重新提交 60 个失败的,比重新提交全部 1,000 个省 94%。
不同错误类型需要不同修复
| 类型 | 数量 | 修复方式 |
|---|---|---|
| 上下文超限 | 40 | 对超大文档分块 |
| 无效输入 | 5 | 修正格式错误的请求 |
| 过期 | 15 | 原样重新提交(瞬态问题) |
不修根因就盲目重试,会得到一模一样的错误。先把超大文档分块再重新提交。修正格式错误的输入。只有瞬态故障(过期)可以原样重试。
流程
- 解析 JSONL 结果
- 按
result.type过滤(errored/expired) - 用
custom_id匹配回原始请求 - 分类错误类型
- 按类别应用针对性修复
- 只把修复后的失败项作为新 batch 重新提交
一句话总结: 按状态解析 batch 结果,用 custom_id 匹配失败项,按错误类型修根因(超大文档分块、格式错误修正、过期重试),只重新提交失败项——不是整个 batch。