Skip to Content
快速開始請求日誌

請求日誌

OfoxAI 預設零資料留存(ZDR),不保存請求內容。排查問題時,團隊可以開啟「日誌保留」,在控制台逐筆查看每次請求的完整輸入和輸出。

請求日誌預設關閉。沒有開啟的團隊,請求內容不會被保存,開啟之前的請求也無法回頭查看。

能看到什麼

開啟後,新請求會保存輸入、輸出、工具呼叫和錯誤原因。請求和回應裡的圖片需要另外勾選「同時保存圖片」才會保存。

在 請求明細 裡,有日誌的請求會帶標記,點開就能依時間軸查看這次請求的每一步,以及耗時、Token、費用等概要。

開啟日誌保留

只有團隊擁有者和管理員可以開啟。

  1. 開啟 控制台  的 請求明細
  2. 點右上角 日誌保留
  3. 點 開啟日誌保留
  4. 在「保存哪些請求」裡選擇範圍:
    • 所有 API Key:可以排除個別 Key
    • 指定的 API Key:只保存列出的 Key
  5. 視需要勾選「同時保存圖片」

設定只對之後的新請求生效。

保存上限

項目上限
保存時長最近 3 天
保留筆數最近 1 萬筆
儲存空間1 GB

任一項達到上限時,會自動清除最舊的日誌。需要保存更久,請寄信到 hi@ofox.ai 告訴我們。

敏感資訊處理

保存前,API Key、token、密碼、Cookie、私鑰和帶簽章的連結參數會替換為 [REDACTED]。

手機號碼、電子郵件等個人資訊不會被處理。如果請求裡包含使用者的個人資料,請在開啟前評估,或用下面的請求標頭略過保存。

單次請求不保存

在請求裡加上請求標頭,即可略過這一次的保存:

X-OfoxAI-Log-Content: off
from openai import OpenAI client = OpenAI( base_url="https://api.ofox.ai/v1", api_key="<你的 OFOXAI_API_KEY>", ) response = client.chat.completions.create( model="anthropic/claude-sonnet-5.5", messages=[{"role": "user", "content": "這筆請求不保存日誌"}], extra_headers={"X-OfoxAI-Log-Content": "off"}, )

誰能查看

操作團隊擁有者 / 管理員一般成員
開啟、關閉、調整範圍✅❌
查看日誌內容✅❌
刪除日誌✅❌

一般成員需要查看某次請求的完整內容時,請聯繫團隊管理員。

刪除與關閉

  • 刪除單筆日誌:在請求詳情裡刪除。
  • 依時間範圍刪除:在日誌保留設定裡點「刪除已保存的日誌」,可以選最近 1 小時、今天、全部或自訂時間範圍。刪除後無法復原,呼叫紀錄、Token 用量和費用不受影響。
  • 關閉日誌保留:關閉後新請求不再保存。已保存的日誌不會立即刪除,會在保存期滿後自動清除;需要立即刪除,請使用上面的刪除功能。

常見問題

為什麼某筆請求點開顯示「沒有保存日誌」?

可能是:請求發生在開啟之前;所屬的 API Key 不在保存範圍內;請求帶了 X-OfoxAI-Log-Content: off;或者日誌已過期、已被刪除。

開啟日誌會額外收費嗎?

不會。日誌保留不額外收費,呼叫紀錄、Token 用量和計費方式不變。

和零資料留存(ZDR)是什麼關係?

沒有開啟日誌保留的團隊仍是零資料留存。開啟後,保存範圍內的請求內容依上面的上限保存。詳見 安全與資料。

最後更新於