openrouter-usage

OpenRouter の使用状況

コマンドラインから OpenRouter API のコストを照会し、使用状況レポートを生成します。

使用する場面

• 過去 30 日間の OpenRouter の利用額を確認する
• モデル、プロバイダー、日付ごとにコストを分類する
• 会計処理用に使用状況データを CSV または JSON としてエクスポートする
• 最も多くのクレジットを消費しているモデルと API キーを監査する

前提条件

• OPENROUTER_API_KEY 環境変数（またはプロジェクトの .env ファイル）
• キーは必ず Management キーである必要があります。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 エンドポイント

どちらのエンドポイントも、Bearer トークンによる認証を使用する読み取り専用の GET リクエストです。

エンドポイント	用途
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 を返します。