> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 调用日志保存多久？多久清理一次？

> API易 只保存计费所需的日志，不存输入输出内容。日志滚动保留最近约 2 个月，每月 5 日、15 日、25 日各清理一次，每次删除距今 2 个月以前的数据；需要长期留存请在日志页面自行异步导出。

## 简短回答

<CardGroup cols={3}>
  <Card title="只存计费信息" icon="receipt">
    日志里只有时间、模型、token 数、金额等计费必需字段，**不存你的输入和输出内容**
  </Card>

  <Card title="滚动保留最近 2 个月" icon="calendar">
    每月 **5 日、15 日、25 日**各清理一次，每次删除**距今 2 个月以前**的数据。例：**8 月 15 日清理 6 月 15 日之前**
  </Card>

  <Card title="需长期留存请自行导出" icon="download">
    在后台**日志**栏目使用**异步导出**下载后自行归档，用于对账等用途
  </Card>
</CardGroup>

<Warning>
  **清理不可恢复**。被清理的日志无法找回，有对账、审计、报销需求的用户请在清理日之前完成导出。
</Warning>

## 日志里存了什么

| 会记录 | 不会记录 |
| - | - |
| 调用时间戳 | prompt 原文 / 对话内容 |
| 模型名与所属分组 | 模型输出的正文 |
| 输入 / 输出 token 数 | 生成的图片、视频文件本体 |
| 本次消费金额 | 上传的文件、图片内容 |
| 调用状态、耗时等 | 个人身份信息 |

我们只保留计费与故障排查必需的基础信息，这既是隐私最小化的要求，也直接降低了数据泄露的风险面。日志各列的含义见[怎么看懂日志里的计费金额](/faq/log-billing-explained)。

## 图片、视频能在后台看到吗

这是被问得最多的一个衍生问题，答案取决于调用方式：

<CardGroup cols={2}>
  <Card title="同步调用：看不到" icon="eye-off">
    文本、图像等同步接口的结果**直接返回给你的程序，不落库**。后台既看不到 prompt，也看不到生成的图片。
  </Card>

  <Card title="异步任务：能看到，但链接短期有效" icon="clock-alert">
    视频等**异步任务**需要「先提交、后轮询」，结果必须暂存才能被查询，因此后台可以看到任务产物。
  </Card>
</CardGroup>

<Warning>
  **异步任务产物的 OSS 链接有效期约 1 天**。视频、图片的下载地址会在约 24 小时后失效，过期无法再取回。**请在拿到结果后尽快转存到你自己的存储**，不要把这些临时链接直接用在生产环境或分享给终端用户。
</Warning>

## 清理节奏

日志采用**滚动保留**，规则很简单：**每月 5 日、15 日、25 日各执行一次清理，每次删除距今 2 个月以前的数据**——一个月清理 3 次，任意时刻能查到的是**最近约 2 个月**的日志。

| 清理时间 | 被清理的数据 | 清理后可查范围 |
| - | - | - |
| 8 月 15 日 | 6 月 15 日之前 | 6 月 15 日 — 8 月 15 日 |
| 8 月 25 日 | 6 月 25 日之前 | 6 月 25 日 — 8 月 25 日 |
| 9 月 5 日 | 7 月 5 日之前 | 7 月 5 日 — 9 月 5 日 |

<Note>
  因为每 10 天执行一次、按日切分而不是按整月，实际可查窗口会在 **2 个月到 2 个月零 10 天**之间浮动：刚过清理日时最短，下次清理前最长。
</Note>

<Info>
  **本页即清理公示，不再逐次公告。** 清理按上述固定节奏自动执行，我们不会在每次清理前单独发通知，请以本页规则与时间表为准。
</Info>

<Accordion title="为什么一个月要清理 3 次？">
  日志表的体量增长很快，**单次删除一整月的数据量过大，会拖慢数据库并影响线上调用**。拆成每 10 天一小批执行，运维压力和对线上请求的影响都更小，这也是我们把节奏从「每月 1 次整月清理」调整为「每月 3 次滚动清理」的原因（自 2026 年 8 月 15 日起生效）。
</Accordion>

<Info>
  **清理的是调用日志明细，账户余额不受影响。** 若你还需要长期留存充值与对账凭据，同样建议一并导出保存。
</Info>

## 需要长期留存怎么办

<Steps>
  <Step title="进入日志页面">
    打开 `https://api.apiyi.com/log`，或从顶部导航进入**日志**栏目。
  </Step>

  <Step title="按需筛选">
    先按时间范围、模型或状态筛出你要归档的记录，避免导出无关数据。
  </Step>

  <Step title="使用异步导出">
    点击**异步导出**发起任务。导出在后台执行，数据量大时不必守在页面上等待。
  </Step>

  <Step title="下载并自行归档">
    任务完成后下载文件，保存到自己的存储或财务系统里。
  </Step>
</Steps>

<Tip>
  **建议养成按月导出的习惯**：每月初把上个月的日志导出一份存档，就不必担心清理日的时间点。有对账、报销、审计需求的团队尤其推荐。
</Tip>

## 常见问题

<AccordionGroup>
  <Accordion title="为什么不长期保存日志？">
    两个原因：**隐私最小化**——留存越少，风险面越小；**存储成本**——调用量大的平台，日志的体量增长很快，长期全量保存的成本最终会体现在价格上。我们选择只保留对账所需的窗口期，并把导出能力开放给用户自行留存。
  </Accordion>

  <Accordion title="已经被清理的日志还能恢复吗？">
    不能。清理是物理删除，无法找回，客服也无法协助恢复。请在清理日之前完成导出。
  </Accordion>

  <Accordion title="清理会影响我的余额或充值记录吗？">
    不会。清理针对的是调用日志明细，账户余额不受影响。如果你需要长期保存充值与消费凭据用于报销或审计，请一并导出留档。
  </Accordion>

  <Accordion title="排查问题时日志不够详细怎么办？">
    在保留窗口内，提供**日志中的时间戳和模型名**就足以定位绝大多数问题。如果确需更细的记录，可联系客服由管理员**临时开启**详细日志协助排查，详见[能否在后台看到详细日志](/faq/user-logs-control)。
  </Accordion>

  <Accordion title="导出的文件里有我的输入输出内容吗？">
    没有。导出的是日志本身，字段与后台展示一致——时间、模型、token 数、金额、状态等，不含任何 prompt 或模型输出内容。
  </Accordion>

  <Accordion title="企业客户能否延长保留期？">
    有特殊留存或合规要求的企业客户，可以联系商务另行沟通。常规做法仍建议以定期导出为主，见[企业服务说明](/faq/enterprise-vs-individual)。
  </Accordion>
</AccordionGroup>

## 相关文档

* [如何查看我的调用记录？](/faq/call-logs)
* [怎么看懂日志里的计费金额？](/faq/log-billing-explained)
* [为方便排查问题，可以在后台看到详细日志吗？](/faq/user-logs-control)
* [API易 如何保障数据安全？](/faq/data-security)
* [图片生成有异步接口吗？](/faq/image-async-api)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.