Gemini 新项目默认存请求,关日志前先看会话怎么续接
10 月 26 日起,新付费项目的 Generate Content API 默认存储请求。分清项目设置、单次 store、数据集分享与其他保留用途,并避免关闭 Interactions 存储后丢失续接能力。

同一段 Gemini 调用代码,放在旧项目和新项目里,日志表现可能不同。Google 从 10 月 26 日起,让新建付费项目的 Generate Content API 默认存储请求;已有项目保留原设置。没有显式配置 store 的应用,应该把这项差异加入部署检查。
这会影响排错资料和会话数据的保存,但“存了请求”也不能直接推导为“同意用于训练”。日志存储、数据集分享,以及服务条款中的其他保留用途,要分别核对。
本文于 2026 年 11 月 16 日核对更新记录、日志配置和数据分享政策。下文描述官方 Gemini API 的付费项目日志,不把规则套到所有免费服务或第三方网关;没有进入真实项目改设置,也未发送验证请求。
先确认项目日期和所用接口
官方把这两种默认行为分开说明:
| 使用路径 | 默认行为与影响 |
|---|---|
| 10 月 26 日起新项目的 Generate Content API | 默认 store=true,可在项目或请求层调整 |
| 之前创建的项目 | 保持原 Generate Content 设置;原本未开启时仍为关闭 |
| Interactions API | 默认存储,并用于服务端会话状态管理 |
这里的 Generate Content 包括 generateContent、streamGenerateContent 和 batchGenerateContent。日志能力适用于付费项目,也覆盖文档所列的 OpenAI 兼容调用;不代表每种模型和输入都能显示日志。当前限制清单仍包含某些模型,以及含视频、GIF、PDF 的输入等情况。
在 AI Studio 的 Logs 页面选对项目,进入 Settings,Generate Content 与 Interactions 的开关分别检查。不要只记账号名:同一账号可能有多个项目,应用运行时使用的 Key 也可能指向另一项目。
对单次请求,明确写下存储选择
请求级 store 优先于项目设置。官方 Python google-genai 从 2.33.0 起支持 Generate Content 的该配置;不要假设所有旧 SDK 都能发送它。
下面使用官方默认服务与环境变量中的官方 Key;正文不包含真实凭据:
from google import genai
# Requires google-genai >= 2.33.0 and GEMINI_API_KEY in the environment.
client = genai.Client()
response = client.models.generate_content(
model="gemini-4-hydrogen",
contents="Public demo: explain what an API gateway does in one sentence.",
config={"store": False},
)
print(response.text)
本文只检查了 Python 语法,没有运行这次模型调用。迁移已有程序时,还应检查封装层是否过滤参数;能在本地代码看到 store=False,不证明目标供应商实际收到它。
经过网关时,要同时核对客户端请求、网关转发与上游规则。Gemini 原生兼容文档说明本站调用入口,但本文未验证该字段经 Nbility 转发的行为,也不以官方参数代替本站的数据处理承诺。
关掉 Interactions 存储,会改变服务端历史能力
Interactions 的存储不只服务于排错界面,还关联自动保存和读取会话历史。官方提醒,在项目设置里关闭其 logging 后,除非单次请求显式覆盖,否则会阻止这部分服务端状态管理。
如果应用用上一轮交互 ID 继续对话,应先决定:保留适用的存储,还是由应用维护必要历史并按接口要求提供。不能只把开关关掉,再把续接失败当网络问题。
这与Claude 短期 thread是不同产品机制,但都需要回答同一个应用问题:服务端不再拥有可复用历史时,自己有没有足够记录继续任务?不要混用两家的参数、寿命或恢复方式。
日志、数据集和其他保留是三件事
官方日志默认保留窗口为 55 天,可以调为 7、14、28 或 55 天。到期是标记删除,不应写成某时刻已经从所有介质立即清除。被保存到 dataset 的日志没有固定到期时间,需要单独管理。
数据分享政策说明,这些日志默认供项目自己使用,付费项目的日志默认不用于产品改进;主动分享数据集则适用另一套数据使用条件。创建 dataset 时,要认真检查分享选项和必要权限,不把“导出排错样本”顺手做成对外贡献。
另外,Gemini 条款仍说明付费服务会为滥用检测等用途有限期记录提示与响应。开发者日志开关不覆盖所有此类记录,因此 store=false 不能被改写成“Google 完全不保留任何数据”。第三方客户端、工具、网关和自己应用的副本也各有保存路径。
可以给每个正式项目留一份简短记录:项目创建时间、实际 API、SDK 版本、两类默认开关、请求覆盖策略、日志窗口,以及 dataset 的负责人。再用公开短文本发一次请求,检查实际日志和会话表现;本文没有执行这一验证。保留哪些诊断字段,可参考最小日志模板;涉及凭据副本,再按API Key 保存方法处理。


