核心用法
OpenRouter Usage Monitor 是一款专为 OpenRouter 平台设计的费用监控工具，主要功能包括：
- 实时总额查询：获取今日、本周、本月的累计消费与账户余额（
/auth/key端点） - 历史模型明细：拉取过去 7 天各模型的详细支出与调用次数（
/activity端点，需 MGMT_KEY）
执行方式灵活，首选 Python3 脚本 scripts/stats.py，支持环境变量或 credentials.env 文件配置凭证；当 Python 不可用时自动降级至 curl + jq 命令行方案。
显著优点
1. 双轨架构：主备执行路径确保高可用性，适应不同运行环境
2. 分层权限：标准 API_KEY 获取基础账单，可选 MGMT_KEY 解锁模型级粒度分析
3. 清晰输出：结构化展示今日/周/月费用、余额及模型排行，带星号标记提示数据延迟
4. 合规授权：采用 Apache-2.0 开源协议，企业友好
潜在局限
/activity仅返回已完成 UTC 日数据，当日消费存在滞后显示- 依赖外部网络与 OpenRouter 服务可用性
- 未内置持久化存储或告警机制
- 需用户自行管理密钥安全
适合人群
- 多模型调用场景下的成本管控人员
- 需要按模型维度优化预算的开发者与团队
- 关注实时余额避免透支的 OpenRouter 重度用户
常规风险
- 凭证泄露：API_KEY/MGMT_KEY 若硬编码或误提交有被盗刷风险
- 权限边界：MGMT_KEY 通常拥有更高读取权限，需最小化暴露
- 网络中间人：curl 回退路径未强制校验证书时需确保 TLS 完整性
- 速率限制：高频查询可能触发 429，影响其他业务调用