博客

Gemini 預設儲存付費請求:變更內容與停用方式

Gemini 於 10 月 26 日變更預設設定:新建立的付費級別專案會儲存 Generate Content 請求,除非你主動停用。本文整理受影響的專案、資料保留期限,以及停用方式與代價。

Gemini 預設儲存付費請求:變更內容與停用方式

Gemini 在 October 26 變更的是預設設定,而不是推出新功能。付費方案中呼叫 Generate Content API 的新專案,現在預設會儲存請求,與 Interactions API 原本的行為一致。你的程式碼不必做任何變更,這項設定就會生效,也正因如此,才值得檢查:實際判斷時,先看專案建立日期,再看資料分級,最後決定是否停用儲存。

簡單說:在 2026-10-26 當天或之後建立的專案,預設會儲存請求;較早建立的專案則保留現有設定,除非先前已在 AI Studio 啟用記錄功能,否則維持關閉。如果需要停用儲存,可以針對個別請求或整個專案設定,而個別請求的設定優先。這兩種方式都有一個容易忽略的代價,而代價就是狀態。

以下內容皆依據官方的版本資訊、記錄與資料集指南,以及 Interactions API 文件,並已於 2026-10-27 查核。變更正式環境設定前,請先對照這些頁面確認。

官方說法:有哪些變更

版本說明很精簡,值得仔細引用:付費層級中,使用 Generate Content API,也就是 generateContent、streamGenerateContent 和 batchGenerateContent 的新專案,現在預設會以 store=true 儲存請求,與 Interactions API 一致。既有專案則維持目前的設定。

這段話有兩個細節,比乍看之下更重要。第一,變更範圍僅限新專案,因此包含多個專案的工作區可能同時存在兩種行為。第二,這項變更涵蓋三種呼叫形式,包括批次呼叫,因此只稽核互動式呼叫的團隊,仍可能儲存了批次請求流量。

同一份說明也列出了停用方式:在個別請求中設定 store=false,或到 Logs and Datasets 儀表板的設定面板,關閉 Generate Content API 記錄功能。

如何判斷你是否受到影響

先看專案建立日期。Logs 指南明確說明了分界:2026-10-26 當天或之後建立的專案,預設會儲存 Generate Content 請求;在該日期之前建立的專案,預設則不會儲存請求,除非已在 AI Studio 中啟用記錄功能。

接著檢查你實際使用的端點。涵蓋範圍說明比 API 名稱所暗示的更廣:記錄功能支援 GenerateContent、BatchGenerateContent 和 StreamGenerateContent 呼叫,也支援 Interactions API 呼叫,但不包含 Managed Agents,並且明確涵蓋透過 OpenAI 相容端點發出的呼叫。只換了基底 URL 的閘道或用戶端仍在涵蓋範圍內;如果稽核只用 grep 搜尋 Gemini SDK 的使用情況,這就是最容易漏掉的部分。

最後,確認方案等級。只有付費方案的專案才能使用 Gemini API 記錄儲存功能。這與更新日誌的描述一致,也代表這項變更不影響免費方案的專案。

同一份指南還有一項操作上的附註:專案至少需要一把有效的 API 金鑰,才會顯示記錄。如果專案中的所有金鑰都被刪除,就會看不到記錄,直到專案再次有金鑰為止。這在處理事件時很重要,因為有時會先輪替或撤銷金鑰,之後才展開調查。

儲存的請求會保留多久

保留期限與儲存是分開的設定,預設值也寫得很清楚。記錄預設會在 55 天後到期,並標記為待刪除;但儲存至資料集的記錄除外,資料集不會到期。專案的保留期限可設為 7、14、28 或 55 天,上限為 55 天。

這帶來三個結果。預設值就是允許的最長期限,因此團隊若想縮短期限,就必須主動設定,不能依賴預設值。資料集是明確的例外,因此必須保留的記錄適合放在資料集,但原本打算讓它到期的資料就不適合。再者,保留期限是專案層級的控制項,因此資料類別不同的專案,不應在無意間沿用相同設定。

Interactions API 文件也為其物件說明了相同的保留機制,但依方案等級有所不同:付費方案的互動保留 55 天,免費方案則保留 1 天;付費專案可在 AI Studio 中將期限設為 7、14、28 或 55 天。較短的期限可能會影響過往對話的擷取。

停用儲存的兩種方式,以及哪一種優先

逐一請求的做法,是將 store 參數設為 false。這種方式很精準:你可以針對含有敏感內容的呼叫停用儲存,同時保留其他呼叫的可觀測性。代價是必須嚴格落實,因為每個請求都得帶上這個旗標,只要有一個用戶端忘了帶,就會再次寫入儲存空間。

專案層級的做法,是在 Gemini API Logs 儀表板的「設定」面板中,分別切換 Generate Content API 和 Interactions API 的儲存功能。設定一次就會套用到該專案的每一次呼叫,包括不是你寫的程式所發出的呼叫,例如廠商 SDK,或使用同一把金鑰的內部工具。

優先順序規則決定了設定衝突時以誰為準:請求層級的 store 屬性優先於專案層級的設定。這讓例外處理很方便,但也是個警訊。如果專案層級的開關已關閉,應用程式卻設定了 store=true,資料仍然會被儲存。光是稽核儀表板還不夠;也必須檢查請求的處理路徑。

對於原本就有意記錄提示詞的團隊,供應商端的儲存不能取代你們自己的紀錄,而你們自己的紀錄也不該變成所有內容的第二份副本。

選擇不儲存的代價

這正是隱私開關變成架構決策的關鍵。Interactions API 文件指出,store=false 與背景執行不相容,也會讓後續對話輪次無法使用 previous_interaction_id。

簡單說:有了儲存,才有伺服器端的對話狀態和長時間執行的背景工作。關閉儲存,該請求就無法使用這些功能。因此,如果處理流程是圍繞著透過 ID 延續對話來設計,就得改用其他設計:要麼每次都傳送相關歷史紀錄,要麼接受無法使用有狀態功能的限制。

同一份文件也提到,伺服器端狀態並非必要;只要在每次請求中傳送完整的對話歷史紀錄,就能以無狀態方式運作。這確實是一條可行的路,不是死路,但會改變 token 用量和應用程式邏輯。在切換正式環境的處理路徑之前,先用不含敏感資料的流量測試。

另外,也有一種值得了解的刪除方式。使用付費方案時,可以隨時透過 delete 方法刪除已儲存的互動,但必須提供互動 ID。這對設計的意義有點像繞了一圈,卻很實在:如果從未儲存那次互動,就沒有可供刪除的 ID。刪除是保留資料之後的補救措施,不能取代一開始就決定不保留資料。

為什麼以 Interactions API 為基準

這次預設值變更,最適合解讀為行為對齊。Interactions API 原本就預設儲存請求,以支援 previous_interaction_id、background=true 和可觀測性;現在,Generate Content API 在新專案中也採用相同的行為。

策略上的關鍵細節在 Interactions 文件裡:未來,所有新模型、多模態能力、工具和代理功能都會在 Interactions API 上推出。同一頁也將原有的 generateContent API 描述為舊版,但仍提供完整支援。

制定政策時,應以這句話為依據。如果你計畫採用的能力,都將在狀態功能仰賴儲存的 API 上推出,那麼一律「全面關閉儲存」就不是長久之計。長久之計是分級處理:依資料類別個別決定,在需求允許的範圍內盡量縮短保留期間,並明確指出哪些工作負載需要有狀態功能。

對於同時管理多個專案或客戶的團隊,同樣的邏輯也適用於租戶邊界;多租戶指南 說明了如何隔離配額與金鑰,而儲存設定也應納入同一份逐租戶檢查清單。如果你透過 OpenAI 相容層轉送請求,請在自己的整合審查中,加上一項供應商端儲存預設值的檢查。

經得起下一次預設值變更的政策

預設值會持續變動,兩個方向都可能,而每次變動都會透過版本說明公告,但多數團隊都是事後才讀到。因應之道是一套簡單、明確的政策,而不是一次性的開關設定。

先將流量分類。含有客戶內容、憑證或受法規管制資料的請求,可考慮在請求層級設定 store=false。內部除錯流量通常正好相反:保留這些流量,才能實現可觀測性;日誌記錄指南 說明了該記錄哪些內容,同時避免記錄機密資訊。API 金鑰安全管理指南 則從憑證的角度說明同一道界線。

接著,將保留期間設為滿足需求的最短期間,並記住預設值就是最長期間,而且資料集不會到期。依互動 ID 記錄誰刪除了哪些內容,這樣才能以證據而非記憶回覆刪除請求。

最後,將這項檢查納入整合流程。審查新供應商或端點時,會用到 API 整合檢查清單 和內部文件;「這家供應商預設會儲存什麼、保留多久,以及我們要如何關閉儲存」應與基底 URL 和模型 ID 一起列入審查。

檢查清單

  1. 列出各專案及其建立日期;2026-10-26 這個分界日決定預設設定。
  2. 確認流量是否透過 OpenAI 相容端點存取 Gemini,而不只是透過原生 SDK。
  3. 將資料分類:客戶內容、受法規管制的資料與內部除錯流量,可能需要不同的設定。
  4. 針對敏感呼叫,逐一在請求中設定 store=false;對於完全不應儲存資料的專案,則使用專案層級的開關。
  5. 停用儲存前,先測試工作負載是否依賴 previous_interaction_id 或 background=true。
  6. 根據需求將保留期限設為 7、14、28 或 55 天,不要依循預設值。
  7. 將必須保留的證據存入資料集,並依互動 ID 記錄刪除作業。
  8. 將「供應商端的儲存預設設定與保留期限」納入供應商整合審查。

這項變更本身只是版本說明中的一行文字。它所帶來的工作,則是制定一份簡短政策,依專案與資料類別套用,並在關閉任何設定前,先了解狀態管理上的取捨。請到官方頁面確認目前的行為,因為下一次的預設設定可能會朝相反方向調整。

以上所有細節均依據 2026-10-27 查核的官方頁面;在據此採取行動前,請先對照目前的文件確認。