OpenRouter Usage Monitor 综合评估
核心用法
本 Skill 专为追踪 OpenRouter AI 平台的使用成本而设计，通过调用官方 /auth/key 和 /activity 两个端点获取数据。OPENROUTER_API_KEY 为必需凭证，可获取实时账户余额及今日/本周/本月的消费总额；选配 OPENROUTER_MGMT_KEY 后，可解锁过去 7 天的模型级支出明细（按 UTC 日期聚合）。支持 Python 主路径和 curl 备选方案，兼容有/无 jq 环境。
显著优点
- 实时性强：直接对接 OpenRouter 官方 API，数据延迟极低
- 双维度视图：既提供宏观账户余额，又支持微观模型级成本归因
- 容错设计：Python 不可用时自动降级为 shell/curl，降低环境依赖
- 安全灵活：优先推荐环境变量注入，支持本地文件回退，避免硬编码
潜在局限
/activity端点仅返回已完成的 UTC 日数据，今日消费需次日才能看到模型级明细- 管理密钥为可选配置，缺少时无法做成本归因分析
- 依赖外部网络，离线环境不可用
- 无内置持久化，历史数据无法跨会话累积
适合人群
- 需要监控多模型 AI 支出的开发团队
- 按项目核算 API 成本的财务/运营人员
- 需要快速排查异常消耗的 DevOps 工程师
常规风险
- 密钥泄露：若误将
credentials.env提交至版本控制，可能导致账户被盗刷 - 429 限流：高频调用可能触发速率限制，需实现指数退避重试
- 401/403 失效：密钥被轮换或权限变更时，需及时更新环境变量