Cost & Spend Tracking (日本語)

これは何か（そして何ではないか）

OmniRoute は、トークン数にモデルの料金レートを掛けることで、完了リクエストごとの USD コストを算出します。これらの数値は、Costs ダッシュボード、 omniroute cost / omniroute usage CLI、CSV/JSON エクスポート、API キーごとの予算に使用されます。

ダッシュボードの「コスト」は請求額ではなく、節約額トラッカーです。 OmniRoute が料金を請求することはありません — リクエストは、すでに接続済みのプロバイダー（ご自身のサブスクリプション、無料枠、API キー）へルーティングされます。すべて無料モデルの利用で累積した「合計コスト $290」は、有料 API に対しておよそ $290 を支払わずに済んだことを意味します。この数値は、同じトラフィックを標準の定価で処理した場合にかかっていたコストの_見積もり_です。そのため、利用がどこに集中しているか、より安価または無料のプロバイダーへのルーティングによってどれだけ節約できているかを確認できます。

この位置づけは、プロジェクトの README にも明記されています（「ダッシュボードの『コスト』は請求額ではなく、節約額トラッカーです」）。

この数値は見積もりであるため、以下の点に注意してください。

各モデルについて OmniRoute が保持する料金表に依存します。料金エントリがないモデルのコストは 0 として計上されます（エクスプローラーでは「Legacy / Free」行として表示されます）。
無料枠やサブスクリプションのトラフィックにも_推定_コストが計上されます — これは支払うべき金額ではなく、節約できた金額です。

コストの見積もり方法

料金の取得元

コストは、以下の優先順位で解決される料金表から算出されます（src/lib/pricingSync.ts）。

ユーザーによる上書き — ダッシュボードまたは PATCH /api/pricing を介して設定した料金。
同期された外部料金 — 同期が有効な場合に LiteLLM の公開 model_prices_and_context_window.json から取得されます（上書き設定を変更しないよう、独立した pricing_synced 名前空間に保存されます）。
ハードコードされたデフォルト値 — OmniRoute に同梱されています。

外部料金の同期はオプトインで、デフォルトでは無効です。関連する環境変数は .env.example を参照してください。

環境変数	デフォルト	用途
`PRICING_SYNC_ENABLED`	`false`	起動時にバックグラウンドでの LiteLLM 料金同期を有効にします。
`PRICING_SYNC_INTERVAL`	`86400`	同期間隔（秒単位、デフォルトは毎日）。
`PRICING_SYNC_SOURCES`	`litellm`	カンマ区切りのソース一覧（現在は `litellm` のみサポート）。

コストの計算式

コストは、トークン数と 100 万トークンあたりの料金に基づき、リクエストごとに src/lib/usage/costCalculator.ts （computeCostFromPricing / calculateCost）で計算されます。

入力トークン（キャッシュ読み取りトークンとキャッシュ作成トークンを除く）× input 料金。
キャッシュ読み取りトークン × cached 料金（未設定の場合は入力料金を使用）。
キャッシュ作成トークン × cache_creation 料金（未設定の場合は入力料金を使用）。
出力トークン × output 料金。
推論トークン × reasoning 料金（未設定の場合は出力料金を使用）。

すべての料金は、1,000,000 トークンあたりの USD として解釈されます。Codex の「fast」/「priority」または「flex」サービス階層にはコスト倍率（getCodexFastCostMultiplier）が適用されます。たとえば flex ではトークン料金が 50% 割引され、ダッシュボードに flex savings として表示されます。

最初にモデル名が正規化され（openai/ や accounts/fireworks/models/ などのプロバイダーパスのプレフィックスが削除されます）、過去の行も料金に一致するようにします。

支出の記録方法

リクエストごとのコストはレスポンス後に計算され、クライアントへのレイテンシーを一切増やさないよう、完了を待たずに記録されます。共有クォータの消費は、 src/lib/quota/spendRecorder.ts を介して次のイベントループのティックにスケジュールされます。

API キーの支出はバッファリングされ、 SpendBatchWriter によりバッチ単位でフラッシュされます（デフォルトのフラッシュ間隔は 60 秒、バッファは 1,000 エントリ）。以下で調整できます。

環境変数	デフォルト	用途
`OMNIROUTE_SPEND_FLUSH_INTERVAL_MS`	`60000`	フラッシュ間隔（ミリ秒単位）。
`OMNIROUTE_SPEND_MAX_BUFFER_SIZE`	`1000`	フラッシュ前にバッファリングする最大エントリ数。

ダッシュボードのコスト数値は、保存された行ごとの金額から読み取られるものではありません。分析エンドポイントが実行されるたびに、トークン数と現在の料金表から動的に再計算されます。つまり、誤った料金を修正して再同期すると、過去のコスト見積もりにも遡及的に反映されます。

ダッシュボード：コストページ

Costs ページは /dashboard/costs （src/app/(dashboard)/dashboard/costs/）にあります。メインビューは Cost Overview タブ（src/app/(dashboard)/dashboard/costs/CostOverviewTab.tsx）で、すべてのデータを GET /api/usage/analytics から読み込みます。

表示内容：

支出タイル — 今日（1d）、7d、30d、および選択した期間の推定支出。期間セレクター：7d、30d、90d、all。
主要指標 — 期間内のリクエスト数、アクティブなプロバイダー数、アクティブなモデル数、リクエストあたりの平均コスト。
コストエクスプローラー — プロバイダー、モデル、API キー、アカウント、またはサービスティア別にグループ化できる、並べ替え／フィルタリング対応のテーブル。コスト、リクエスト数、トークン数、リクエストあたりの平均コスト、合計に占める割合（%）を表示します。
トークン使用量 — 合計／入力／出力トークン数と、入力：出力比率。
ルーティング効率 — フォールバック数、フォールバック率、およびリクエストされたモデルのカバレッジ。
月次予測 — 直近の日次平均から月末時点の支出を予測します。
期間比較 — 期間の前半と後半の変化率（%）。
チャート — 日次コスト推移、プロバイダー構成比（円グラフ）、上位プロバイダー、上位モデル、API キー別コスト、アカウント別コスト、週次利用パターン、アクティビティヒートマップ。
エクスポート — 現在の期間を CSV または JSON としてダウンロードします（コストデータが 0 でない場合にボタンが表示されます）。

価格設定済みのトラフィックがない場合、行には $0 の代わりに「Legacy / Free」ラベルが表示され、節約トラッカーモデルを反映します。

API エンドポイント

特記がない限り、これらすべてで管理認証（requireManagementAuth を介したループバック／JWT）が必要です。

使用量とコストの分析

メソッド	エンドポイント	目的
`GET`	`/api/usage/analytics`	コスト／使用量の完全な分析：概要、日次推移、プロバイダー／モデル／API キー／アカウント／ティア別。クエリ：`range`、`startDate`、`endDate`、`apiKeyIds`、`presets`。
`GET`	`/api/usage/utilization`	プロバイダーごとのクォータ使用率の推移。クエリ：`range`（`1h`/`24h`/`7d`/`30d`）、`provider`。
`GET`	`/api/usage/history`	生の使用履歴行。
`GET`	`/api/usage/call-logs`	リクエストごとの呼び出しログ（モデル、トークン、コスト、レイテンシー、ステータス）。
`GET`	`/api/usage/quota`	プロバイダーのクォータステータス。
`GET`	`/api/usage/proxy-logs`	プロキシリクエストログ。

予算

メソッド	エンドポイント	目的
`GET`	`/api/usage/budget`	1 つの API キーに対するコスト概要と予算チェック（`apiKeyId` クエリパラメーターが必須）。
`POST`	`/api/usage/budget`	API キーの日次／週次／月次 USD 上限と警告しきい値を設定します。
`GET`	`/api/usage/budget/bulk`	API キー全体の予算概要を一括取得します。

Budget API のスコープは API キー（apiKeyId）単位です。 GET /api/usage/budget が返す上限には、dailyLimitUsd、weeklyLimitUsd、monthlyLimitUsd、 warningThreshold、および累計値（totalCostToday、totalCostMonth、…）が含まれます。

価格設定

メソッド	エンドポイント	目的
`GET`	`/api/pricing`	現在の統合済み価格設定（ユーザー設定 + 同期済み設定 + デフォルト）。エントリごとのソースを確認するには `?includeSources=1` を使用します。
`PATCH`	`/api/pricing`	`{ provider: { model: { input, output, cached, … } } }` の価格設定を上書きします。
`DELETE`	`/api/pricing`	価格設定をデフォルトにリセットします（`?provider=&model=` によるスコープ指定も可能）。
`GET`	`/api/pricing/defaults`	100 万単位あたりのデフォルトのフォールバック料金を表示します。
`GET`	`/api/pricing/models`	モデルをキーとした価格設定。
`POST`	`/api/pricing/sync`	外部ソース（LiteLLM）からの手動同期を開始します。
`GET`	`/api/pricing/sync`	現在の同期ステータス。
`DELETE`	`/api/pricing/sync`	同期済みの価格データをすべて消去します。

その他のコスト関連エンドポイント

メソッド	エンドポイント	目的
`GET`	`/api/free-tier/summary`	無料モデルのトークン合計、今月の使用量、残りの無料枠。
`GET`	`/api/quota/pools/[id]/usage`	共有クォータプールの使用量。

CLI

OmniRoute の CLI は、コスト、使用状況、料金に関するコマンドを提供します（bin/cli/commands/registry.mjs で登録されています）。

`omniroute cost`

/api/usage/analytics から集計されたコストレポートです。

omniroute cost                          # 過去 30 日間、プロバイダー別にグループ化
omniroute cost --period 7d              # 過去 7 日間
omniroute cost --group-by model         # provider | model | combo | api-key | day でグループ化
omniroute cost --since 2026-06-01 --until 2026-06-13
omniroute cost --api-key &lt;key&gt; --limit 50

列：グループ、リクエスト数、入出力トークン数、コスト（USD）、合計に占める割合（%）。末尾には総合計行が出力されます（--quiet または --output json を指定すると省略されます）。

`omniroute usage`

omniroute usage analytics --period 30d [--provider &lt;id&gt;]   # プロバイダー別のコスト概要
omniroute usage logs [--limit 100] [--follow] [--api-key &lt;k&gt;] [--search &lt;q&gt;]
omniroute usage quota [--provider &lt;id&gt;] [--check]
omniroute usage utilization [--api-key &lt;k&gt;]
omniroute usage history [--limit 100]
omniroute usage proxy-logs [--limit 100]

# 予算
omniroute usage budget list
omniroute usage budget get [scope]
omniroute usage budget set &lt;amount&gt; [--scope global] [--period monthly]
omniroute usage budget reset [scope]

`omniroute pricing`

omniroute pricing list [--provider <p>] [--model &lt;m&gt;] [--limit 200]
omniroute pricing get &lt;model&gt;
omniroute pricing sync [--provider <p>] [--force]   # POST /api/pricing/sync
omniroute pricing diff [--model &lt;m&gt;]
omniroute pricing defaults show
omniroute pricing defaults set [--input <p>] [--output <p>] [--cache-read <p>] [--cache-write <p>]

pricing defaults show は GET /api/pricing/defaults を読み取ります。代わりに個々のモデルの料金を編集するには、ダッシュボードの Pricing ページまたは PATCH /api/pricing を使用してください。

トラブルシューティング

すべてのコストが $0 / 「Legacy / Free」と表示される。 使用中のモデルに料金情報がありません。外部同期を有効化（PRICING_SYNC_ENABLED=true）して omniroute pricing sync を実行するか、Pricing ページまたは PATCH /api/pricing から料金を手動で設定してください。
過去に使用したモデルの料金が正しくない。 料金を修正してください（上書きまたは再同期）。分析データを読み取るたびにトークン数からコストが再計算されるため、見積額は過去分にも遡って更新されます。
支出額の反映がリアルタイムより遅れる。 キーごとの支出額はバッチ処理されます。より新しい数値が必要な場合は、OMNIROUTE_SPEND_FLUSH_INTERVAL_MS を小さくしてください。

ダッシュボード全体における位置づけについては、ユーザーガイドおよび機能ギャラリーを参照してください。

OmniRoute ソースコード (a58000c7685f)

HagiCode

HagiCode は構造化ワークフロー、マルチエージェント実行、Hero Dungeon ビューを備えたエージェント型コーディングワークスペースです。

よりスマートで速く、楽しいエージェント型ワークフローで、使いやすいソフトウェアを形にします。

Smart構造化ワークフローは意図をアイデアから変更のリリースまで実行可能な道筋にします。
Efficientマルチエージェントのワークフローで調査、実装、レビューを並行して進めます。
FunHero Dungeon により長時間のコーディングを視覚的で協力的な体験にします。

HagiCode を見る

言語を選択