mcpField
O
openrouter-usage

openrouter-usage

github.com/tdimino数据与数据库4152 次安装1 周前更新
代码仓库

关于 openrouter-usage

面向需要核算 OpenRouter API 支出的用户，提供命令行用量查询与报告导出。报告按模型、提供商和日期汇总费用，并显示积分余额及令牌用量。

主要功能

  1. 01查询积分余额
  2. 02按模型汇总支出
  3. 03按提供商和日期汇总
  4. 04导出 CSV 或 JSON
  5. 05查看令牌用量

适用场景

  1. 01检查近 30 天的 API 支出
  2. 02按模型或提供商核对费用
  3. 03导出用量数据用于会计
  4. 04审计模型与 API 密钥的额度消耗

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/tdimino/claude-code-minoan --skill openrouter-usage

安装后在 Claude Code 中输入/openrouter-usage确认已加载。

附带文件README.mdscripts/openrouter_usage.py

详细介绍

OpenRouter 用量

通过命令行查询 OpenRouter API 费用并生成用量报告。

适用场景

  • 查看过去 30 天的 OpenRouter 支出
  • 按模型、提供商或日期细分费用
  • 将用量数据导出为 CSV 或 JSON，用于会计核算
  • 审查哪些模型和 API 密钥消耗的额度最多

前提条件

  • 设置 OPENROUTER_API_KEY 环境变量（或将其写入项目的 .env 文件）
  • 密钥必须是管理密钥——请在 https://openrouter.ai/settings/management-keys 创建
  • 常规的充值密钥调用分析端点会返回 401/403 错误

用法

# Full 30-day summary with credits balance
python3 ~/.claude/skills/openrouter-usage/scripts/openrouter_usage.py

# Filter to a single date
python3 ~/.claude/skills/openrouter-usage/scripts/openrouter_usage.py --date 2026-02-01

# Export as CSV (for spreadsheets)
python3 ~/.claude/skills/openrouter-usage/scripts/openrouter_usage.py --csv

# Raw JSON output (for piping to jq)
python3 ~/.claude/skills/openrouter-usage/scripts/openrouter_usage.py --json

# Skip credits lookup (activity only)
python3 ~/.claude/skills/openrouter-usage/scripts/openrouter_usage.py --no-credits

输出

默认报告包括：

  • 额度余额：累计购买、已使用和剩余的额度
  • 按模型统计的支出：各模型的费用及令牌数量（提示词、补全、推理）
  • 按提供商统计的支出：按提供商汇总（OpenAI、Anthropic、Google 等）
  • 按日期统计的支出：每日支出及可视化条形图

API 端点

两个端点均为只读 GET 请求，通过 Bearer 令牌进行身份验证：

端点用途
GET /api/v1/credits累计购买和已使用的额度
GET /api/v1/activity按模型/端点/提供商分组的过去 30 天用量

activity 端点的每行数据包含：date、model、provider_name、usage、byok_usage_inference、requests、prompt_tokens、completion_tokens、reasoning_tokens。

评论

支持 Markdown