为什么模型 API Key 不能用？

Gemini 模型 Key 用于模型调用，不能代替费用报告与 IAM 授权。请按第 4–7 步创建最小权限服务账号和 JSON 私钥。本接入不接收个人 OAuth 凭据、Cookie 或外部身份配置。

403、API 未启用或角色创建失败怎么办？

依次检查顶部项目、4 个已启用 API、项目 IAM 中服务账号邮箱和自定义角色绑定。角色权限须与 JSON 一致，其中 billing.resourcebudgets.read 读取该单项目预算，不需要给整个结算账号管理员权限。Preview API/自定义角色如受组织限制，联系管理员确认支持情况，不用 Owner/Editor 兜底。

同步成功但费用为零，或刷新后没变化？

只表示当前报告没有匹配 Gemini SKU 的已报告费用。核对项目与是否实际走 Vertex AI，并等待可能超过 24 小时的上报。手动刷新不会加速 Google 结算；不能据此认定有余额。

为什么费用成功而限额暂未获取或未配置？

检查单项目预算读取权限、匹配的 Gemini/月度/排除 Credits 范围及实际 Spend cap。普通告警预算、不同服务、多项目预算和 AI Studio 限额不会显示成 Cloud Billing 上限。配置变更中、重复匹配、不同币种或接口失败显示暂未获取，不会显示为零。

币种不一致或与账单金额不同？

使用官方报告的三位币种重新配置监控；本站不换汇，不会把人民币误标为美元。核对太平洋月份、项目、Gemini 服务、Credits 前费用与报告延迟。若两个结算币种混在报告中，查询失败而不是相加。

为什么还有差额但 Gemini 已停止调用？

上限执行读取更新更快的方向性费用，另有 AI Studio 项目限额、账号限制和实际资金条件。本页差额只做费用信息展示，不能作为调用可用性承诺。请到官方平台查看限制原因。

Gemini API 返回 402 Payment Required 是什么原因？

官方说明这表示预付（Prepay）Credits 已用完：结算账号余额为 0 时，关联到该账号的所有项目、所有 API Key 会同时停止，直到充值或开启自动充值，重试不会成功。预付 Credits 购买后 12 个月过期。结算账号达到所在等级的月度上限时，所有关联项目也会暂停到下个月 1 日。本站读取的是报告费用与 Cloud Billing 消费上限，不读取预付 Credits 余额。

Gemini API 费用与限额查询教程：Google 服务账号最小权限配置

仅费用 · 非余额

教程更新2026-10-10

费用与限额功能已实现，待真实账号验证；使用 Google App Optimize 预览接口，未确认真实项目覆盖率或最小 IAM 授权实测。不是预付余额查询。

所需凭据: Google 服务账号 JSON
监控币种: 官方账单币种 · 例如 USD、CNY、JPY
可以看到什么: 已报告费用 / Cloud Billing 月消费上限 / 已报告费用差额 · 非余额; 从当前美国太平洋时间月份的首日到查询时刻，读取指定 Google Cloud 项目的官方费用报告，并以 Cloud Billing 目录中 Gemini API 服务 AEFD-7695-64FA 的 SKU 精确筛选。以账单返回币种展示扣减赠金前费用，不换汇、不按 Token 价格估算，不包含 Vertex AI。

如何在 AI Studio 手动查看 Gemini API 费用与消费上限

打开 AI Studio 的 Billing 页面，查看结算账号、预付 Credits 与费用构成。
打开 Spend 页面，在 Monthly spend cap 中查看或修改项目的月度消费上限。
需要按 SKU 细看时，在 Google Cloud 控制台打开 Cloud Billing Reports，按 SKU 分组并筛选 Gemini API 服务。
计费数据处理约有 10 分钟延迟，Billing 与 Spend 页面的费用图表最长可能需要 24 小时更新。

打开 AI Studio Billing

在 Quota Monitor 中接入 Gemini / Google AI Studio

1. 确认需要的是费用监控
打开 Google AI Studio，用管理 Gemini API 的 Google 账号登录；如要看精确预付余额，请在官方 Billing 中查看，本接入不能替代。配置云权限需要项目管理员协助，日常查询使用专用服务账号。完成后检查：接受费用可能延迟超过 24 小时，且不把差额当钱包余额。
打开 Google AI Studio（在新标签页打开）
2. 找到模型 Key 对应的 Google Cloud 项目
在 AI Studio 的 API Keys 页面查看业务 Key 所属项目，再到 Google Cloud 控制台顶部项目选择器选中同一项目。在项目设置中复制 Project ID（类似 my-gemini-project），不是显示名称或纯数字 Project number；不要复制模型 Key。打开 Billing，确认项目已关联结算账号，并记下账单币种。完成后检查：项目 ID、业务 Key 的所属项目和币种一致。
打开 Google Cloud 项目设置（在新标签页打开）
3. 启用查询所需的 API
保持顶部选中目标项目，进入 APIs & Services → Library，依次搜索并启用 App Optimize API、Cloud Billing API、Cloud Billing Budget API、Cloud Resource Manager API。已经 Enabled 的不要重复操作；App Optimize 是 Preview，如组织不允许启用，请停止并联系管理员，不要改组织安全策略。完成后检查：Enabled APIs & services 列表包含 appoptimize.googleapis.com、cloudbilling.googleapis.com、billingbudgets.googleapis.com 和 cloudresourcemanager.googleapis.com。
打开 API Library（在新标签页打开）
04
4. 创建项目级最小权限角色
点击控制台右上方 Activate Cloud Shell，由管理员确认目标项目。在 Cloud Shell 的编辑器中用 File → New File 新建 quota-monitor-gemini-role.json，粘贴下方完整 JSON 并保存。回到 Cloud Shell 终端运行：gcloud iam roles create QuotaMonitorGeminiCost --project=PROJECT_ID --file=quota-monitor-gemini-role.json。把 PROJECT_ID 替换为第 2 步的项目 ID；不要保留占位文字。
若角色已存在，先在 IAM & Admin → Roles 查看内容，只有确认同用途且权限一致才复用，不要覆盖其他业务角色。Cloud Shell 不是 Quota Monitor 的终端。完成后检查：角色 QuotaMonitorGeminiCost 已出现在该项目中，且只有下方 7 项权限；创建角色不等于已授权。
项目级费用报告角色 JSON（含创建临时报告权限）
```
{
  "title": "Quota Monitor Gemini Cost",
  "description": "Read project costs and budgets; create temporary cost reports.",
  "stage": "BETA",
  "includedPermissions": [
    "appoptimize.reports.create",
    "appoptimize.reports.getData",
    "appoptimize.operations.get",
    "billing.resourceCosts.get",
    "billing.resourcebudgets.read",
    "resourcemanager.projects.get",
    "serviceusage.services.use"
  ]
}
```
复制的是完整 JSON，不含密钥或账号信息。
打开项目角色管理（在新标签页打开）
5. 创建独立服务账号
打开 IAM & Admin → Service Accounts，确认还是同一个项目，点击 Create service account。填写名称 quota-monitor-gemini，创建后跳过可选角色和用户访问授予步骤；下一步再精准绑定自定义角色。服务账号是程序使用的身份，不是个人 Google 登录账号。完成后检查：记录新账号的完整邮箱，后缀为 .iam.gserviceaccount.com，且没有继承或额外授予 Owner/Editor 等广泛权限。
打开服务账号（在新标签页打开）
6. 将角色授权给该服务账号
进入目标项目 IAM → Grant access，在 New principals 填第 5 步的服务账号邮箱，Select a role 搜索并选择 Quota Monitor Gemini Cost，保存。不是将角色授权给你自己的登录邮箱，也不要选择项目 Viewer/Editor/Owner 模板。完成后检查：IAM 列表中该服务账号的成员行确实绑定了第 4 步的项目级角色；只有角色定义没有这条绑定，查询仍会被拒绝。
打开项目 IAM 授权（在新标签页打开）
7. 创建并保管 JSON 私钥
返回 Service Accounts，打开该账号 → Keys → Add key → Create new key → JSON → Create。浏览器下载 JSON 文件，用安全编辑器查看，确认 type 为 service_account，project_id 是目标项目，包含 private_key、private_key_id 和 client_email。不要用 API Keys 页创建的模型 Key 代替。
文件包含可长期使用的私钥，请保存在密码管理器或安全位置，不上传 Git、不发聊天或工单。若组织禁止创建服务账号密钥，本版本暂不支持其他身份方式；不要解除禁令绕过。完成后检查：同一个专用账号的完整 JSON 已妥善保存，Keys 中只保留所需密钥。
返回服务账号与 Keys（在新标签页打开）
8. 可选：确认已有的 Cloud Billing 消费上限
由结算/项目管理员打开 Billing → Budgets & alerts，查看用于 Gemini 的预算详情。本站只识别已配置 Spend cap、范围仅为当前项目与 Gemini API 服务、周期为 Month、排除所有 Credits 的上限。普通发送邮件告警的预算不会当作硬上限，其他服务或多项目预算也不会套用。
不需要为了接入而新建或修改生产消费上限；没有符合条件的上限仍可查询费用。在 AI Studio 创建的限额未必是此 Cloud Billing 上限。完成后检查：明确你核对的是哪一种上限，或者接受仅显示费用；本站不创建、修改或解除上游限制。
打开 Google Cloud Billing（在新标签页打开）
9. 在 Quota Monitor 项目内添加连接
进入 Quota Monitor 的目标业务项目 → 添加供应商连接 → Gemini / Google AI Studio（费用与限额）。填写连接名称，将 JSON 文件的全部文本复制到 Google 服务账号 JSON 密码框；不用上传或粘贴到聊天。Google Cloud 项目 ID 留空默认使用 JSON 的 project_id；要查询另一个项目，须先在那个项目完成启用 API 和同一账号的角色绑定，再填其 Project ID。
将 Google 账单币种填成第 2 步确认的三位大写代码，如 USD、CNY 或 JPY，本站不自动换汇。点击保存并接入项目。完成后检查：连接出现在正确业务项目，密码没有回显；保存失败时只检查格式与权限，不公开 JSON 内容。
10. 同步并识别费用、上限和差额
等待首次同步，或点击同步费用。同步会申请短期访问令牌、读取 Gemini SKU 目录、创建并读取临时费用报告，再单独读取匹配的消费上限。费用分页未完成不保存部分金额；上限查询失败仍保留成功费用并显示暂未获取。完成后检查：卡片是本月已报告费用而不是账户余额，显示太平洋月份与账务延迟；Cloud Billing 上限、按报告计算的差额及官方限制状态分别展示。
11. 与官方同范围对账
在 Cloud Billing Reports 选择同一项目、本月、Gemini API 服务，按相同币种比较扣减 Credits 前的费用；不要拿整个结算账号、Vertex AI、赠金后净费用或 AI Studio 预付余额对比。还要分别查看 Cloud Billing 的 Spend cap 和 AI Studio 的 Limits。完成后检查：时间、服务、项目和费用口径一致；若刚产生调用，等待官方账单上报，不根据本页正差额判断一定还能调用。
打开官方费用报告入口（在新标签页打开）
12. 定期轮换和撤销密钥
在同一专用服务账号的 Keys 中创建新 JSON，通过本站连接管理更新凭据并确认同步成功，再删除旧密钥。停用时先移除项目监控/删除本站连接，再在 Google 撤销该专用密钥与不再需要的角色绑定；不要删除其他业务账号或角色。完成后检查：旧密钥已失效、只保留需要的授权。反馈问题只提供错误码和时间，绝不附私钥或访问令牌。

Quota Monitor 读取的 Gemini / Google AI Studio 数据范围

App Optimize 为预览服务；费用通常一天内报告，也可能延迟超过 24 小时。手动刷新只重读已上报数据，成功同步时间不是账单结算截止时间。零费用仅表示没有已报告费用，不能证明未消费或还能调用。
不查询 Gemini 预付余额、个人 Gemini 订阅、Vertex AI 或账号全部云账单。不支持按单个 API Key 筛选费用；同一个 Google 项目下的 Key 共用该项目费用范围。
只读取 Cloud Billing 中匹配单项目、Gemini 单服务、按月且排除 Credits 的实际 spendCap。普通预算告警不是消费上限；AI Studio 自身项目限额、结算账号 tier 限额不在此查询范围内。
差额是同币种同范围上限减去已报告费用，不是实时可用额度。上限执行基于更新更快的估计费用，可能在本页仍显示差额时已阻止调用；以官方状态为准。缺失、拒绝访问、翻页失败或配置变更中显示暂未获取，不用零或无限代替。
每次同步会在目标项目创建一个临时费用报告，Google 自动于 24 小时后过期清理；此创建权限不是账单修改或充值权限。预览期间报告 API 本身无额外费用，仍受 Google 条款、配额和其他云服务计费约束。
教程与模拟回归不等于真实账号验收。请先用权限受控的小项目核验数据；不要为排错授予管理员权限、停用组织安全策略或发送私钥。
面板展示最近一次成功的费用快照。刷新无法消除上游账务延迟；失败后保留的旧费用和旧时间不是新报表。

Gemini / Google AI Studio 常见问题与排查

为什么模型 API Key 不能用？: Gemini 模型 Key 用于模型调用，不能代替费用报告与 IAM 授权。请按第 4–7 步创建最小权限服务账号和 JSON 私钥。本接入不接收个人 OAuth 凭据、Cookie 或外部身份配置。
403、API 未启用或角色创建失败怎么办？: 依次检查顶部项目、4 个已启用 API、项目 IAM 中服务账号邮箱和自定义角色绑定。角色权限须与 JSON 一致，其中 billing.resourcebudgets.read 读取该单项目预算，不需要给整个结算账号管理员权限。Preview API/自定义角色如受组织限制，联系管理员确认支持情况，不用 Owner/Editor 兜底。
同步成功但费用为零，或刷新后没变化？: 只表示当前报告没有匹配 Gemini SKU 的已报告费用。核对项目与是否实际走 Vertex AI，并等待可能超过 24 小时的上报。手动刷新不会加速 Google 结算；不能据此认定有余额。
为什么费用成功而限额暂未获取或未配置？: 检查单项目预算读取权限、匹配的 Gemini/月度/排除 Credits 范围及实际 Spend cap。普通告警预算、不同服务、多项目预算和 AI Studio 限额不会显示成 Cloud Billing 上限。配置变更中、重复匹配、不同币种或接口失败显示暂未获取，不会显示为零。
币种不一致或与账单金额不同？: 使用官方报告的三位币种重新配置监控；本站不换汇，不会把人民币误标为美元。核对太平洋月份、项目、Gemini 服务、Credits 前费用与报告延迟。若两个结算币种混在报告中，查询失败而不是相加。
为什么还有差额但 Gemini 已停止调用？: 上限执行读取更新更快的方向性费用，另有 AI Studio 项目限额、账号限制和实际资金条件。本页差额只做费用信息展示，不能作为调用可用性承诺。请到官方平台查看限制原因。
Gemini API 返回 402 Payment Required 是什么原因？: 官方说明这表示预付（Prepay）Credits 已用完：结算账号余额为 0 时，关联到该账号的所有项目、所有 API Key 会同时停止，直到充值或开启自动充值，重试不会成功。预付 Credits 购买后 12 个月过期。结算账号达到所在等级的月度上限时，所有关联项目也会暂停到下个月 1 日。本站读取的是报告费用与 Cloud Billing 消费上限，不读取预付 Credits 余额。

Gemini / Google AI Studio 官方资料

教程由 Quota Monitor 整理，非供应商官方教程。平台界面和权限可能变化，请以官方页面为准；实测范围以本页说明为准。