OpenAI Batch API 的 JSONL、custom_id、input file、output file、error file、completed、expired 和 cancelled 有什么区别？

名称 类型 作用 常见误解

-----------

JSONL 文件格式 每行一个完整JSON请求对象 误写成一个JSON数组

customid 开发者提供的行级ID 把输出映射回输入 误以为输出保持输入顺序

input file 已上传File对象 保存批次请求行 误当作模型知识文件

Batch object 作业元数据 记录endpoint、状态、计数和文件ID 误认为包含全部结果正文

output file 结果JSONL 保存已执行请求的逐行响应 误认为只有200响应才会出现

error file 错误JSONL 保存没有正常响应对象的失败行 忽略部分失败

completed 批次终态 批次处理与finalizing已结束 误解为100%请求成功

failed 批次状态 批次级验证或处理失败 与单行HTTP失败混为一谈

expired 批次终态 窗口结束，未执行请求取消 误以为已完成结果也丢失

cancelled 批次终态 用户取消流程结束 误以为瞬间停止且不计费