Claude Message Batches 结果怎么取:过期、取消与逐条对账

用 Anthropic 官方批处理文档说明 custom_id、四种结果状态、24 小时过期和结果保留期,给出逐条核对流程。

关键词
LALondAI 内容团队发布日期 2026-11-22
6 分钟阅读模型教程
LA
Claude Message Batches 结果怎么取:过期、取消与逐条对账
Claude Message Batches官方来源与可执行检查LondAI 内容团队

Claude Message Batches 适合能等待结果的大批量任务。提交成功只说明批次被接收,不代表每条请求成功;最终必须按 custom_id 逐条取回、核对状态和用量,不能把批次状态 ended 当成“全成功”。

官方结果有哪些状态

Anthropic 批处理指南列出 succeeded、errored、canceled、expired 四种逐条结果。错误、取消以及在发送给模型前过期的请求不计费。批次的 request_counts 可看处理进度,但结果文件才可定位每个业务项。文档说明批次最多 100,000 条请求或 256 MB,以先到的边界为准;超过 24 小时未处理的请求会过期,结果在创建后可下载 29 天。以上是官方第一方 API 规则,不代表 LondAI 目前开放同等批处理接口。

为什么不能按提交顺序回填

批次异步执行,结果行的排列不应当作原始任务顺序。提交前给每条请求分配稳定且不含敏感信息的 custom_id,保存“业务任务 ID → custom_id → 批次 ID”的映射。下载结果后用 custom_id 关联原任务;成功才取消息与用量,失败记录错误类型,取消和过期回到待重试队列。结果接口说明明确每行是单条请求的 JSON 对象,因此不能只检查文件是否非空。

可复现的验收流程

  1. 在获授权的 Anthropic 测试工作区提交两条脱敏短请求,分别用唯一 custom_id 标记;保存批次 ID 和提交时的请求数量。
  2. 按官方示例轮询批次,直到处理结束;下载结果文件并逐行解析,检查 custom_id 没有重复或遗漏,结果数与提交数一致。
  3. 对 succeeded 取回内容、模型名和 usage;对 errored 保存错误分类;对 canceled 与 expired 标记未完成,不生成成功业务记录。
  4. 人工触发一次取消测试:取消可能先进入 canceling,最终批次仍可能有已完成的部分结果。重提时只重试未完成项,保持业务幂等。

结果保存和费用边界

批次属于创建它的工作区,跨工作区 Key 不能直接取回。结果保留 29 天不代表可以等到最后一天才对账;应在业务允许的时限内下载并安全保管必要结果。官方说明批次提示词缓存命中是尽力而为,不能把缓存折扣当作固定收益。本文未使用 LondAI 用户 Key 实测,也没有改动本站网关、余额或使用记录。

上线通过标准

验证全成功、单条错误、批次取消、24 小时过期和重复下载;确认每个 custom_id 最多形成一次成功状态,汇总 usage 与供应商账单一致。通用异步任务方案见批量模型任务设计,本站支持范围以LondAI 接入文档与实际测试为准。