多模态大文件上传怎么验收：分片、断点续传、校验和与临时 URL 的 AI API 测评

多模态应用把视频、扫描件和高分辨率图片送入模型时，最脆弱的环节往往不是推理，而是上传。网络中断、重复分片、文件替换和过期下载链接都会让“上传成功”的界面与真实文件不一致。若下游模型处理了错误版本，排查成本会远高于普通文本请求。

分片协议要能证明完整性

每个上传会话应有不可预测的会话 ID、明确分片序号、总大小和每片校验和。服务端接受分片后返回已确认的范围，客户端重连时只补未确认部分。不要仅以文件名判断重复上传；同名文件可能内容完全不同，同内容文件也可能属于不同租户和不同授权语境。

断点续传的负面测试

主动在上传中途断网、重复发送同一分片、打乱分片顺序、篡改最后一片、取消后重试。验收标准是：不会拼出静默损坏文件，不会双重计费，不会把取消任务遗留在队列里。对于浏览器上传，还要验证刷新页面后会话恢复是否需要重新确认身份。

临时 URL 不是永久访问控制

对象存储的预签名 URL 应限制方法、对象键、大小、内容类型和短时过期。把 URL 写入工单、聊天记录或模型提示词都会扩大泄露面，因此日志只记录对象指纹和过期状态。模型处理完成后，应按业务规则删除临时对象、派生缩略图和失败分片。

用统一入口观察整条链路

通过 top-api.cc 管理不同模型的文件调用时，可关联上传会话、文件摘要、模型任务和最终结果，而不需要把长期存储凭证交给每个业务客户端。这样还能按文件类型统计失败率和成本，识别某个供应商对大文件或特定编码的异常。

发布前的检查项

• 完成合并前校验总大小和整体哈希；
• 同一分片的重复提交是幂等的，冲突提交被拒绝；
• 取消、过期和失败会清理临时对象；
• 文件 MIME、实际内容和扩展名交叉验证；
• 结果引用的是不可变文件版本，而不是可被覆盖的路径。

上传链路可靠，模型的多模态能力才有可验证的输入基础。否则再高的识别准确率也可能建立在错误文件之上。