> ## 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 數 | 生成的圖片、影片檔案本體     |
| 本次消費金額          | 上傳的檔案、圖片內容       |
| 呼叫狀態、耗時等        | 個人身份資訊           |

我們只保留計費與故障排查必需的基礎資訊，這既是隱私最小化的要求，也直接降低了資料洩露的風險面。日誌各列的含義見[怎麼看懂日誌裡的計費金額](/zh-Hant/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="排查問題時日誌不夠詳細怎麼辦？">
    在保留視窗內，提供**日誌中的時間戳和模型名**就足以定位絕大多數問題。如果確需更細的記錄，可聯絡客服由管理員**臨時開啟**詳細日誌協助排查，詳見[能否在後臺看到詳細日誌](/zh-Hant/faq/user-logs-control)。
  </Accordion>

  <Accordion title="匯出的檔案裡有我的輸入輸出內容嗎？">
    沒有。匯出的是日誌本身，欄位與後臺展示一致——時間、模型、token 數、金額、狀態等，不含任何 prompt 或模型輸出內容。
  </Accordion>

  <Accordion title="企業客戶能否延長保留期？">
    有特殊留存或合規要求的企業客戶，可以聯絡商務另行溝通。常規做法仍建議以定期匯出為主，見[企業服務說明](/zh-Hant/faq/enterprise-vs-individual)。
  </Accordion>
</AccordionGroup>

## 相關文件

* [如何檢視我的呼叫記錄？](/zh-Hant/faq/call-logs)
* [怎麼看懂日誌裡的計費金額？](/zh-Hant/faq/log-billing-explained)
* [為方便排查問題，可以在後臺看到詳細日誌嗎？](/zh-Hant/faq/user-logs-control)
* [API易 如何保障資料安全？](/zh-Hant/faq/data-security)
* [圖片生成有非同步介面嗎？](/zh-Hant/faq/image-async-api)