核心指南

数据保留

了解请求详情和媒体的可用期限,以及如何长期保存重要结果

请求与响应详情、自动保存的媒体结果可查看 30 天。对话历史、账单记录、保存到素材库的内容,以及你下载的文件分别管理。

完整说明请参阅 TokenLab 数据保留说明。

请求与响应详情

已保存的请求与响应内容自记录之日起,可在 Console、Request Debugger 和 TokenLab Agent (Assistant) 中查看 30 天。到期后,这些工具无法再读取原始内容。请求概要、用量和账单记录仍可能保留。如需留存详情,请在到期前下载。

内容过期、从未保存和加载失败是不同状态。排查问题时,请留意页面显示的状态。

生成媒体结果

对于以 HTTP(S) 链接返回、支持自动保存的图片、视频、音频和可下载的 3D 结果(包括 Worlds 文件),TokenLab 会自动保存副本。保存成功的副本自结果首次记录之日起可查看 30 天。再次查看、重试或查询任务状态不会重新计算保留期限。

请以结果旁显示的保存状态和到期时间为准。保存中或保存失败时,原始链接可能在副本可用前失效。如需长期保存,请在结果可用时下载文件或保存到素材库。保存到素材库的副本不会随自动副本的 30 天期限一起过期。

自动保存不包括 Worlds 交互网页、模型引用的外部依赖、内联 Base64 或二进制媒体、输入文件,以及生成文本中的链接。如需日后使用,请自行保存这些结果。任务记录另有保留期限;任务已完成不代表其中的媒体一直可用。

通过 API 查询媒体可用状态

对于支持的结果,AI 协议的 JSON 响应包含 media_retention:其中有 days 和 items,每个项目提供 url、kind、status 和 expires_at。也可在媒体结果 URL 上添加 metadata=true,查询当前状态。状态为 saving 或失败,不代表文件已保存。结果 URL 到期后返回 HTTP 410。

从可用结果获取的下载链接最长有效五分钟。如果链接失效时结果仍在 30 天可用期内,可重新获取链接,但不会延长结果本身的到期时间。

TokenLab Agent (Assistant) 对话历史

这里指你与 TokenLab 内置助手的对话。这些对话与 API 请求日志分开保存,不会因为请求日志满 30 天而自动移除。对话中已保存的文字可能继续保留,但其中引用的请求详情和媒体过期后,无法再通过对话重新加载。

你可以在 Agent 历史记录中移除对话。此操作会将对话从历史列表移除,不代表清除所有关联数据,也不会删除请求、账单、支持工单或 Console 历史记录。助手只能在 30 天可用期内调取原始请求与响应内容;更早的账单和用量记录仍可能用于查询。

其他记录与文件

  • 账户信息、账单与用量历史、任务记录用于账户服务、结算和支持,分别保留,不受请求详情的 30 天期限统一限制。
  • 组织调用记录的导出文件可下载 90 天,请在到期前下载。导出文件过期不会删除原有记录。
  • 在 Console 或 TokenLab Agent (Assistant) 中临时上传的文件,可在 24 小时内用于新请求。超过此期限后,如需在新请求中使用,请重新上传。
  • 你下载或导出的文件、浏览器中的数据,以及你自己的应用保存的副本,由你自行管理。TokenLab 的保留期限不会删除这些副本。

上述期限说明数据在 TokenLab 中可供访问的时间,存储中的删除可能晚于访问到期。处理请求的 AI 服务提供商有各自的数据政策和保留期限。

请求排查请参阅日志与故障排查,媒体任务轮询请参阅异步任务与轮询。

本页内容