OpenRouter Usage

核心用法

OpenRouter Usage Monitor 是一款面向开发者和团队的 API 成本追踪工具，通过调用 OpenRouter 官方接口实现两类核心功能：

1. 实时消费统计：获取今日/本周/本月累计消费及账户余额（/auth/key 端点）
2. 历史模型细分：查看过去 7 天各模型的具体消费金额与请求次数（/activity 端点，需管理密钥）

运行方式

推荐方案（Python）：

export OPENROUTER_API_KEY="sk-or-xxx"
export OPENROUTER_MGMT_KEY="sk-mgmt-xxx"  # 可选，用于模型细分
python3 scripts/stats.py

备用方案（纯 curl）：

• 实时总额：curl -H "Authorization: Bearer $OPENROUTER_API_KEY" https://openrouter.ai/api/v1/auth/key
• 模型活动：curl -H "Authorization: Bearer $OPENROUTER_MGMT_KEY" https://openrouter.ai/api/v1/activity

显著优点

• 双模式兼容：Python 环境友好，同时提供零依赖的 curl 降级方案
• 财务透明：实时余额预警 + 历史模型级成本归因，便于成本优化
• 标准接口：基于 OpenRouter 官方 REST API，数据权威性有保障
• 轻量实现：单脚本设计，无额外依赖（Python 版仅依赖标准库）

局限性与注意事项

| 场景 | 说明 |

|------|------|

| 数据延迟 | `/activity` 仅返回已完成 UTC 日期的数据，当日消费可能延迟 24h 显示在模型明细中 |

| 密钥分级 | 模型级细分需独立的管理密钥（OPENROUTER_MGMT_KEY），普通 API 密钥无法获取 |

| 网络依赖 | 纯云端接口调用，无离线缓存或本地记账能力 |

| 错误处理 | 需手动处理 401/403（密钥无效）、429（速率限制）等状态码 |

适合人群

• 使用 OpenRouter 聚合平台进行多模型调用的开发团队
• 需要按模型维度分析成本结构的 AI 产品经理
• 希望实时监控 API 消费避免超额的个人开发者

常规风险

• 密钥泄露风险：脚本需以环境变量形式承载敏感密钥，共享环境或日志泄露可能导致账户被盗刷
• 费率变动风险：OpenRouter 模型定价由上游提供商决定，历史数据仅供参考，无法预测未来成本
• 数据一致性风险：实时总额与模型明细因统计口径差异（UTC 日 vs 实时）可能存在短期不一致

核心用法

OpenRouter Usage Monitor 是一款轻量级用量监控工具，专为 OpenRouter 平台用户设计。该 Skill 通过调用 OpenRouter 官方 REST API，获取两类关键数据：一是 /auth/key 端点提供的实时汇总数据（今日、本周、本月消费总额及账户余额），二是 /activity 端点返回的 7 天模型级消费明细。用户需配置 OPENROUTER_API_KEY 环境变量以获取基础用量，若需模型级拆分则需额外配置 OPENROUTER_MGMT_KEY。主执行路径依赖 Python 3 标准库，在无 Python 环境时可降级使用 curl + jq 命令行组合，确保跨平台兼容性。

显著优点

极简依赖，开箱即用：纯 Python 标准库实现（urllib、json、os），零第三方依赖，从根本上杜绝供应链攻击风险。代码仅 137 行，结构清晰，审计成本低。功能精准，数据权威：直接对接 OpenRouter 官方 API，数据来源可靠，输出格式简洁明了（今日/周/月费用 + 模型级 7 天明细），满足财务对账与成本优化双重需求。灵活降级：curl 备用方案确保即使在受限环境中也能获取关键数据，体现工程实用性。合规友好：Apache-2.0 开源许可，商业使用无顾虑；通过 GDPR 数据最小化、TLS 加密传输等多项合规检查。

潜在缺点与局限性

数据延迟问题：/activity 端点仅返回已完成 UTC 日期的数据，当日消费在汇总中可见，但模型级明细需待次日 UTC 零点后才更新，实时性存在 0-24 小时不等的时间差。功能单一：专注用量监控，无预测分析、告警通知、多账户聚合等进阶能力，需配合其他工具构建完整 FinOps 体系。凭证管理待优化：当前从本地文件读取 API Key，虽优于硬编码，但未集成系统级密钥管理服务，在多用户共享环境中存在泄露隐患。错误处理简化：缺乏指数退避重试、详细错误分类等生产级健壮性设计，网络波动时易直接失败。

适合的目标群体

• 中小型 AI 应用团队：需要快速了解 OpenRouter 消费分布，无复杂成本管理需求
• 独立开发者与顾问：为客户项目追踪模型调用成本，生成简洁对账报告
• 运维与财务人员：需要非技术友好的用量数据，辅助预算编制与异常消费识别
• 开源爱好者：希望研究极简 API 封装模式，或基于此扩展自定义监控面板

使用风险

凭证安全：API Key 以明文形式存储于本地文件并通过 HTTPS 传输，若设备被入侵或用户误设文件权限，可能导致密钥泄露；建议配合 IP 白名单与定期轮换策略。网络可靠性：依赖 OpenRouter 官方 API 可用性，无本地缓存机制，API 故障或限流（429）时获取中断。数据准确性边界：实时汇总与历史明细存在天然时间差，财务对账时需注意今日数据的两处来源差异（带 标注）。合规使用前提*：用户需自行确保对 OpenRouter 账户数据的查询符合平台服务条款，Skill 本身不提供授权范围校验。