· reAPI Team
API 数据保留:在链接过期前保存输出
规划生成文件、输入上传内容和备份的 API 数据保留。在链接过期前保存输出、验证副本,并检查删除会移除哪些内容。

视频已成功生成。数据库中有任务 ID 和下载 URL。这足以说明结果曾位于何处,却不能算作视频归档。
Replicate 文档所述的默认规则让这一区别变得紧迫:API 预测的输入、输出值、输出文件和日志会在一小时后移除。通过其网站创建的预测遵循另一套规则,会一直保留到手动删除为止。[1] 你仍能在网页会话中看到某个文件,并不能说明 API 结果还能下载多久。
如果之后还需要某项输出,完成流程应将实际字节复制到你控制的存储中,并验证副本。删除时则要同时考虑服务商版本和你创建的副本。沿着一个文件走完这些步骤,保留问题就会变得具体。
为下载设置独立的完成状态
设想一个生成的视频。生成已完成,归档工作进程开始复制输出。应将“生成已完成”与“副本已验证”分开记录。若下载失败,第一个状态仍可能为真,而第二个状态仍为假。
读取已完成任务有文档说明的输出字段,并找出你打算保留的每个文件。对于包含多个输出的任务,应将输出索引或等效标识与任务 ID 一并保存。单个成功标记无法说明多个文件中究竟哪个已复制。
通过应用已授权的访问路径下载,写入目标对象,并在将其显示为已可靠保存之前进行检查。确认目标对象存在、传输已完成,且大小和媒体类型合理。在可行时,打开或解码自有副本。校验和可以验证副本与下载字节的一致性;它不能证明生成的场景正确,也不能证明视频符合客户要求。
将原始 URL、任务 ID、输出标识、目标对象键和复制时间关联保存。之后由应用访问时,使用你自己的对象标识。把临时服务商 URL 另存到数据库的另一列,并不会因此产生独立副本。
如果同一完成通知再次到达,应使用任务和输出标识识别已验证的副本。酌情重试未完成的传输,但不要仅因通知重复就产生无法解释的重复副本。这是建议的应用工作流,并非声称每家服务商都会替你实现归档。
模型成功后,工作进程仍可能失败
在这个视频示例中,假设生成完成时归档工作进程不可用。副本应保持待处理状态。工作进程恢复后,只要源文件仍可用,就可以尝试取回。如果源文件已过期,应记录保存失败,而不是悄悄将任务标记为已归档。
不要重新生成视频并把它说成原文件的恢复。另一次生成是另一项操作,可能产生不同内容,也可能产生另一笔费用。应先检查是否已有经过验证的副本,或服务商是否记录了其他取回途径。例如,fal 表示过期的 CDN 文件会被永久删除,无法恢复。[2]
因此,保留窗口是复制作业设计时必须考虑的输入。如果应用无法在适用窗口内可靠归档,就应调整该工作流,或在承诺之后仍可访问之前安排有文档依据的存储方案。某次观察中链接碰巧有效更久,并不构成存储保证。
reAPI 的任务文档也建议及时复制生成的输出,以便长期归档。文档介绍了重新托管的 CDN 输出,并说明生命周期策略按部署配置,不由该契约保证。[3] 这支持保存自己的副本,但不能据此认定每个返回的 URL 都有固定过期时间或会永久托管。
恢复检查时,使用经授权的合成素材,并在不依赖原始服务商链接的情况下读取目标副本。保留检查结果。仅报告上传成功,不如确认应用能够取回并使用自有对象有用。
请求记录与媒体文件的生命周期可能不同
根据服务规则,示例视频的任务记录可能仍可见,但文件已经无法访问。反过来,移除请求内容也不一定会移除每个媒体对象。确定保留期限前,先明确对象是什么。
fal 文档说明,默认情况下,请求历史中的输入和输出会保留 90 天。其 CDN 文件有单独且可配置的保留期限。X-Fal-Store-IO: 0 控制请求历史载荷存储;X-Fal-Object-Lifecycle-Preference 控制媒体生命周期,且单次请求设置优先于账户默认值。[2] 仅设置历史记录,并不会关闭所有存储。
上传的输入又增加了一个对象。你的源图可能留在自己的存储桶中,而服务商副本被用于生成视频。如果之后需要删除这些副本,应保留它们之间的关联。输出视频的生命周期不能说明其参考图的生命周期。
集合与共享视图又是另一层。fal 表示,启用 Assets、将文件放入集合或分享该集合,都不会延长底层文件的生命周期。[4] 已保存的素材库关系可能比它所指向的可用媒体存续更久。
同样的道理也适用于文档工作流。可复用的 PDF 批注可能包含提取出的内容,而不只是文件引用。如果应用存储了这些内容,应将该副本与原始文档一并纳入保留决策。
删除素材库条目不等于删除文件
假设视频现已归档到你的存储桶中,而你想移除服务商一侧的版本。选择符合该目标的操作。将其从素材库隐藏、移除集合成员关系和删除 CDN 文件是不同的操作。
fal 的 Assets 文档说明,删除素材会将其从素材库和搜索结果中移除,但这本身不会删除底层 CDN 文件。从集合中移除范围更窄:素材仍可能留在素材库和其他集合中。[4] 移除后只检查集合,验证的是视图,而不是文件是否已删除。
对于已完成的生成任务,fal 记录了一项单独的请求载荷删除操作,该操作也会针对 CDN 输出文件。它不会移除 CDN 输入文件,因为这些文件可能被其他请求重复使用。[2] 如果参考图也需要删除,应先检查它是否仍在别处使用,再通过适当的文件操作处理。
在文件层面检查结果。fal 的删除响应包含 cdn_delete_results,其中每个文件都有目标链接和 exception 值;某条记录为 null 表示该项删除成功。[5] 即使整体响应成功,也不能忽略多个输出中某个文件报告的异常。
记录操作时间、目标对象和未解决的失败。之后下载失败,是有关该取回路径的证据,但不能证明所有内部备份或下游副本都已消失。删除情况的说明应限于文档所述操作范围以及你实际检查的结果。
Replicate 网站的 Delete 操作有其单独记录的范围:它会移除预测及相关输出数据和文件。[1] 应根据涉及的创建路径采用对应规则,不要假设每个控制台的删除按钮都和 fal 的素材库操作相同。
跟踪副本在导出文件和备份中的去向
移除服务商版本,并不会移除现在存放在你自己存储桶中的视频。如果客户下载了导出文件,那就是另一份副本。撤销共享链接会停止通过该链接访问,但无法取回接收者已经下载的文件;fal 的共享指南明确区分了这两种结果。[4]
对于你控制的副本,应将任务和输出标识、所有者、存储位置及删除规则与对象一同保留。这样,之后收到删除请求时,就不必依赖临时 URL 或没有标签的导出文件名来处理。也要纳入工作流所创建的生成预览、存储版本和迁移副本。
备份也需要明确决策。按预期的恢复目的保留备份,并考虑恢复的数据应如何与之后的删除操作保持一致。否则,恢复较早的备份可能重新引入应用已经移除的内容。进行存储迁移时,先验证目标位置,再切换引用,并将所有权和保留决策随数据一并迁移。
原件、预览和备份也会占用目标存储空间。估算存储成本时,应计入副本数量及每份副本的保留时间;删除服务商版本不会消除你自己的归档成本。
本文讨论的生成输出契约中,没有普遍适用的七年保留要求。不同类型的记录可能有不同要求;适用于发票的期限不应自动变成每个生成视频的生命周期。应根据对象及其用途定义适用政策,而不是随手选一个熟悉的年限。
数据存储在哪里?在本例中,数据可能存在于服务商的请求历史、CDN 媒体、你拥有的对象、导出文件和备份中。地理位置驻留是另一项合同问题。媒体 URL 无法标明每个副本的处理或存储地点。
分开看待存储、共享和训练问题
数据不用于训练,并不能说明数据从未被存储。OpenAI 的 API 数据指南区分了滥用监控日志与应用状态。零数据保留(ZDR)控制仅适用于符合条件且获批的客户,并且仍受端点和功能限制约束。[6] 应确认实际组织、项目和操作适用的范围。
fal 同样说明,其请求历史和 CDN 设置不会配置部署所有者的应用日志记录或由应用管理的持久存储。对于需要 ZDR 的用户,fal 要求确认端点覆盖范围。[2] 如果工作流还使用应用、工具和你自己的存储,单个请求头无法说明其中每一份副本的情况。
对于这个示例视频,最终记录现在应能回答两个实际问题:哪一份经过验证的副本将用于今后的下载?还有哪些副本已被删除,或仍按明确规则保留?在传输失败或某个文件删除出现异常时,应持续显示问题,直到解决。这样,应用就能区分生成完成、归档可用和删除完成,而不会把它们误当作同一个事件。
参考资料
- Replicate,《数据保留》,官方预测文档。查阅于 2026 年 11 月 16 日;API 默认规则与网站删除的范围不同。
- fal,《数据保留与存储》,官方 Model APIs 文档。查阅于 2026 年 11 月 16 日;请求历史、CDN 和部署所有者的责任各不相同。
- reAPI,任务文档,输出结构和归档建议。于 2026 年 11 月 16 日复核。
- fal,《保留与删除》,官方 Assets 文档。查阅于 2026 年 11 月 16 日;素材库操作、文件生命周期和已下载副本。
- fal,《删除请求载荷》,官方 Platform API 参考。查阅于 2026 年 11 月 16 日;逐文件删除结果。本指南未执行任何删除操作。
- OpenAI,你的数据。查阅于 2026 年 11 月 16 日;训练政策、保留控制和端点限制。