Google AI Usage Monitor

监控 Google AI Studio (Gemini API) 的使用、速率限制和配额消耗,并发送自动告警。

安装

概览

什么是Google AI Usage Monitor

Google AI Usage Monitor 是一款专为监控 Google AI Studio(即 Gemini API)使用情况的智能工具,旨在帮助用户实时掌握 API 配额消耗情况、识别潜在超限风险,并优化资源分配。该工具通过自动化浏览器操作访问 Google AI Studio 的用量仪表盘,提取关键指标数据,如每分钟请求数(RPM)、每分钟令牌数(TPM)以及每日请求数(RPD),从而全面评估当前使用状态。它特别适用于需要长期稳定调用 Gemini API 的开发者、数据科学家或企业团队,能够有效避免因突发流量导致的 API 错误或服务中断。通过预设的告警机制,用户可在用量接近限额时及时收到通知,提前采取应对措施,确保业务连续性。此外,该工具支持多种计费层级,包括免费版、按需付费及高级付费套餐,能够根据不同层级的速率限制提供精准监控。整体设计注重实用性与易用性,无需复杂配置即可集成到日常运维流程中。

核心功能特点

  1. 实时监控 RPM、TPM、RPD 三大核心指标,自动检测使用率是否超过 80% 阈值
  2. 支持按项目维度查看各模型的使用详情,包括限额与实际消耗对比
  3. 内置 Discord 告警功能,在关键指标超标时主动推送通知至指定频道
  4. 基于 OpenClaw 浏览器自动化技术,自动登录并抓取异步加载的用量数据
  5. 每日定时巡检机制,默认每晚 20:00 执行检查并生成结构化报告
  6. 兼容 Google AI Studio 所有计费层级,适配免费版至企业级付费套餐

适用场景

Google AI Usage Monitor 特别适合那些频繁调用 Gemini API 且对稳定性要求较高的应用场景。例如,在构建自然语言处理流水线时,若系统每小时需处理上千次文本生成请求,则极易触发速率限制导致服务降级。此时,该监控工具可帮助运维人员及时发现 TPM 接近上限的趋势,避免生产环境出现 429 错误。对于初创公司或独立开发者而言,使用免费 tier 虽成本低廉,但 2 RPM 和 50 RPD 的限制较为严格,稍有不慎就会耗尽额度。通过每日自动报告,用户可以合理安排测试与部署节奏,防止非计划内的 API 调用耗尽预算。另一个典型场景是机器学习模型训练过程中的批量推理任务,这类任务通常集中爆发大量请求,短时间内可能突破 RPD 或 TPM 限制。借助此工具,团队可以在训练前评估当前配额余量,必要时暂停部分低优先级作业以保障核心任务顺利完成。此外,在企业级部署中,多个项目共享同一 GCP 账户的情况下,区分各项目的使用情况尤为重要。该工具能清晰展示每个项目的付费等级与模型使用情况,便于财务核算与成本控制。无论是个人开发者还是大型组织,都能从中获得清晰的用量洞察与预警能力。