核心功能
OpenRouter Usage Monitor 是一款专为 OpenRouter 平台设计的成本监控工具，提供双重数据视图：
- 实时总额：通过
/auth/key端点获取当日、本周、当月的累计消费与账户余额 - 历史模型明细：通过
/activity端点（需 MGMT Key）获取过去 7 天按模型拆分的消费详情
显著优点
- 多语言支持：主路径使用 Python3，提供无依赖的 curl+jq 备用方案
- 灵活认证：支持环境变量或 credentials.env 文件配置，适应不同安全策略
- 精准成本追踪：区分"实时估算"与"已完成 UTC 日"数据，避免账单困惑
- 轻量零持久化：纯查询操作，不存储敏感凭证或历史数据
潜在局限
- 数据延迟：当日消费仅显示在 totals 中，模型明细需等待 UTC 次日
- 权限分层：模型级分析需要额外的 MGMT Key，普通 API Key 仅能看到总额
- 网络依赖：完全依赖 OpenRouter 服务可用性，无离线缓存能力
- 认证风险：credentials.env 文件若误提交至版本控制可能泄露密钥
适合人群
- 使用 OpenRouter 聚合 API 的开发者与团队
- 需要监控多模型成本分摊的 AI 产品经理
- 追求精细化成本控制的个人高级用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| 密钥泄露 | API Key 和 MGMT Key 具备消费权限，需严格保密 |
| 误读数据 | 今日总额与模型明细时间窗口不一致，可能造成理解偏差 |
| 服务中断 | 网络故障或 OpenRouter 维护时将无法获取数据 |
| 权限配置错误 | 缺少 MGMT Key 时无法访问模型级分析功能 |