> ## 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易 只保存计费所需的日志，不存输入输出内容。日志保留当月加此前两个自然月，每月 5 日清理更早的整月数据；需要长期留存请在日志页面自行异步导出。

## 简短回答

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

  <Card title="保留当月 + 前两个月" icon="calendar">
    每月 **5 日**执行清理，删除更早的整月日志。例：**8 月 5 日清理 5 月整月**，清理后可查 6、7、8 月
  </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 日，删除距今两个月以前的整月日志**——也就是说，你在任意时刻能查到的，是**当月加此前两个自然月**。

| 清理时间     | 被清理的数据 | 清理后可查范围      |
| -------- | ------ | ------------ |
| 8 月 5 日  | 5 月整月  | 6 月、7 月、8 月  |
| 9 月 5 日  | 6 月整月  | 7 月、8 月、9 月  |
| 10 月 5 日 | 7 月整月  | 8 月、9 月、10 月 |

<Note>
  因为清理以整月为单位、且固定在每月 5 日执行，实际可查窗口会在**约 2 个月零几天到 3 个月**之间浮动：刚过清理日时最短，月末时最长。
</Note>

<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)