PuppyIP 资源中心
AI API 教程 6 分钟 发布于 2026-10-29

Gemini API 新付费项目默认保存请求:怎样核对与关闭日志

新建项目不能继续沿用“请求默认不留日志”的旧假设。先核项目创建日期与 API,再检查项目开关和每次请求的 store;关闭日志也不能直接等同于所有数据立即删除。

Gemini API 请求日志 store=false 数据保留

服务对象与地域限制

PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。

代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。

本文要点

  • 10月26日起,新项目的 Generate Content 请求默认保存;既有项目保留原设置。这套日志功能适用于付费层级项目。
  • 逐请求 store 优先于项目开关;Generate Content 与 Interactions 的设置及会话历史影响要分开核对。
  • 日志默认保留55天,数据集另有保留边界;查不到日志不能直接证明没有存储。

哪些项目受影响:先看付费层级与创建日期

Google 10月26日发布说明与当前日志文档确认:该日起创建的新 Gemini API 项目,Generate Content 请求默认启用存储。日志功能目前限付费层级项目;不要把这条规则直接套到 Gemini 消费者聊天应用或 Vertex AI。

10月26日前创建的项目保留既有设置:除非此前在 AI Studio 开启,否则 Generate Content 的默认值仍为 store=false。迁移到一个新项目时,即使程序与模型名称没变,也应重新核对默认设置,而不是继承团队对旧项目的记忆。

怎样判断一次请求:项目默认值之后还要看 store

store 是请求是否进入此日志存储机制的开关。请求显式填写它时,会覆盖项目级设置;因此,仅截取控制台“关闭”的画面,还不足以证明每一个客户端都没有存储请求。

先由有权限的项目负责人确认 AI Studio Logs Dashboard 的 Settings,再分别检查 Generate Content 与 Interactions 开关。随后核对真正发出的请求和 SDK 配置:不填写 store 表示采用默认值,显式 false 才是该请求的关闭指令。检查时无需提交真实密钥、客户文本或生产会话。

修改客户端前:核对 SDK 版本与参数位置

官方列出的 Generate Content store 最低 SDK 版本为:Python google-genai 2.33.0、JavaScript @google/genai 2.31.0、Java google-genai 1.79.0、Go google.golang.org/genai 1.76.0。版本号是参数支持门槛,不能只看到依赖已经安装就认定生效。

Python Generate Content 示例将开关放在 config={'store': False},JavaScript 放在 config: {store: false}。Interactions 示例中的 store 则位于请求顶层。这里仅说明字段位置,没有调用 API;接入层若有包装器,应确认它没有丢弃或覆盖该字段。

在自己获授权的隔离环境,可用不含私人数据的虚构文本检查请求序列化与配置传递。客户端不接受字段时,先核版本和实际 API,再查当前官方示例;换 IP、轮换密钥或增加重试不能解决配置差异。

Interactions 为什么要单独检查:它还管理会话历史

Interactions 本来就默认存储请求,用于服务器端会话状态;previous_interaction_id 可用于接续先前交互。这与10月26日新项目的 Generate Content 默认值变化不是同一项新增行为。

关闭 Interactions 的项目日志后,若没有逐请求覆盖,API 将不再自动存储和取回会话历史。依赖这个功能的应用应先决定后续上下文从哪里提供,再评估关闭后的行为;不能把一次关闭操作同时宣称为隐私验收和多轮对话验收。

保存多久、为什么看不到:把日志与数据集分开

日志默认保留55天,项目可选7、14、28或55天。到期日志会被标记删除,不能把到期时刻写成即时彻底清除的保证;另行保存的数据集不会随这些日志期限自动过期。

文档还说明,项目至少要有一个有效 API key 才能查看日志。删除全部 key 后看不到日志,不代表日志已经删除。因此不要把删 key 当作清理日志的方法,也不要仅凭空列表证明从未保存。

落地检查:记录决定,并保持排错证据最小化

为每个项目记录创建日期、付费层级、所用 API、项目默认值、各客户端的显式 store、SDK 版本及会话历史依赖。把“准备修改”“配置已改”和“受控验证通过”分别记清,避免配置文件里出现 false 就宣布整个系统完成验收。

关闭此日志功能不自动证明零保留、所有历史数据已清除或数据训练条款改变;这些问题需要各自的产品和合同依据。排错可优先保留脱敏错误码、时间与请求标识,另行检查自己的网关、客户端及中转日志。本文没有读取私人项目、调整设置或测试任何人的请求。

资料来源

常见问题

流式、批量与 OpenAI 兼容调用也需要检查吗?

需要。当前日志文档将 generateContent、streamGenerateContent、batchGenerateContent 及 OpenAI 兼容端点列入支持范围。应核对实际接入路径的项目设置和请求参数,不因客户端名称不同就沿用另一套默认假设。

所有模型和文件都会出现在这套日志里吗?

不会。文档列出的不支持范围包括 Imagen、Veo、embedding、Robotics、含视频/GIF/PDF 的输入,以及 Public Preview Agents;Interactions 的 Managed Agents 也不在该日志范围。不能用某种输入未出现推断整个项目没有保存其他请求。

我应该立刻关闭所有日志吗?

应按自己的数据政策和排错、会话需求决定。先确认保存内容、权限与期限,再核对关闭后的功能影响。本文解释公开配置边界,不替团队作一刀切的数据治理决定。