使用量とログ
すべてのキーの利用額、トークン、レイテンシ、エラーを追跡し、個々のリクエストを確認して、課金額を照合します。
ダッシュボードには、すべてのモデルのリクエスト、ツールの実行、ブラウザ実行が記録されます。リクエストは完了から数秒以内に表示されます。
| ページ | 表示内容 |
|---|---|
| 概要 | 利用額、信頼性、レイテンシの推移（チャネルグループ別・モデル別） |
| ログ | すべてのモデルのリクエストと、そのトークン数、課金額、所要時間 |
| ツール | すべてのデータツールとブラウザエージェントの実行と、その結果と課金額 |
| ブラウザエージェント → 履歴 | 最近のブラウザ実行と、そのステップと回答 |
| API キー | 各キーの累計利用額と最終使用日時 |
| 請求 | 残高、クレジット、日別の利用額 |
概要ダッシュボード#
概要では、すべてのキーのトラフィックを過去 24 時間、7 日、30 日、90 日の期間でまとめて表示します。
| 指標 | 意味 |
|---|---|
| 利用額 | 期間中の課金額の合計と、リクエスト数 |
| 成功率 | 成功したリクエストの割合と、失敗した件数 |
| P95 初回トークン時間 | 最初のトークンまでの時間の 95 パーセンタイルと、その平均 |
| スループット | 1 秒あたりの平均出力トークン数 |
| キャッシュヒット率 | プロンプトキャッシュから読み取られた入力トークンの割合 |
| 残高 | 現在の残高と、有効なキーの数 |
合計の下には、利用額とトークンの推移のグラフ、チャネルグループ別とモデル別の内訳、失敗したリクエストをエラーの種類ごとに分けたエラー内訳が表示されます。最初のトークンまでの時間とスループットは、ストリーミングのリクエストで測定します。
データツールとブラウザエージェントの実行も利用額に計上されます。これらは tools グループに表示され、モデル別では tool: に続けてツール ID が表示されます（例：tool:browser-agent）。
ログ#
ログには、モデルのリクエストが新しい順に 50 件ずつ表示されます。チャネルグループ、モデル、API キー（複数ある場合）、ステータス（成功または失敗）で絞り込めます。さらに古いものを見るにはさらに読み込むをクリックします。
| 列 | 意味 |
|---|---|
| 時刻 | リクエストの開始時刻。カーソルを合わせると正確な時刻が表示されます。 |
| モデル | モデル ID。⇢ はストリーミングのリクエストを示します。 |
| グループ | リクエストを処理したチャネルグループ |
| ステータス | あなたに返された HTTP ステータス |
| 入力 | 入力トークン数（プロンプトキャッシュに書き込まれたトークンを含む） |
| キャッシュ | プロンプトキャッシュから読み取られた入力トークン数 |
| 出力 | 出力トークン数（推論トークンを含む） |
| TTFT | 最初のトークンまでの時間（ストリーミングのリクエスト） |
| Tok/s | 1 秒あたりの出力トークン数 |
| 請求額 | そのリクエストにかかった費用 |
行をクリックすると詳細が表示されます：リクエスト ID、リクエストを送ったキー、API 形式（anthropic、openai、gemini のいずれか）、合計の レイテンシ、キャッシュ書き込みと 推論トークン、キャッシュヒット率、失敗したリクエストのエラーの種類、そして アフィニティ です。詳細の最後にあるこのリクエストについてサポートに問い合わせるをクリックすると、リクエスト ID が入力された状態でサポートへの問い合わせが開きます。
| Affinity | 意味 |
|---|---|
new | 会話の最初のリクエスト |
sticky | 会話のチャネルにとどまった 2 ターン目以降のリクエスト。プロンプトキャッシュを再利用できます |
explicit | クライアントが送ったセッション ID によって同じ会話としてまとめられたリクエスト |
none | まとめるべき会話がないリクエスト |
Affinity が費用に影響する理由はプロンプトキャッシュを参照してください。
ログに表示されるもの#
- キーと残高のチェックを通過したすべてのモデルのリクエスト（成功・失敗を問わない）。失敗したリクエストにはステータスとエラーの種類が表示され、課金額は $0 です。
- 最初の段階で拒否されたリクエストは記録されず、課金もされません。キーがない・無効、ボディが JSON でない、不明なモデル、キーの許可リストにないモデル、残高が空、キーのレート制限超過などです。エラーはコードに直接返されます。
ログとツールの実行履歴は 90 日間保存されます。
リクエスト ID#
すべてのモデルのレスポンスには、req_3f9c1a7e5b2d4c6e8a0b1d2f のような x-lovely-request-id ヘッダーが付きます。これはログに表示される リクエスト ID です。すべてのエラーにも付きます。最初の段階で拒否されたリクエスト（無効なキー、残高不足、不明なモデル）はログに表示されませんが、サポートはその ID から追跡できます。
自社の記録にこの ID を残しておき、特定の呼び出しについてサポートに問い合わせる際に添えてください。
curl -sD - -o /dev/null https://lovelyrouter.com/v1/chat/completions \
-H "Authorization: Bearer $LOVELY_API_KEY" \
-H "content-type: application/json" \
-d '{"model": "gpt-6.1-sol", "messages": [{"role": "user", "content": "Hi"}]}' \
| grep -i '^x-lovely'レスポンスには、リクエストを処理したチャネルグループを示す x-lovely-group も付きます。ツールの実行とブラウザ実行は、代わりに実行 ID（run_… または brun_…）で識別します。
ツールの実行#
ツールには、過去 30 日間の実行数、結果数、利用額が表示され、その下にすべての実行が一覧表示されます。各実行には、ツール、ステータス（成功、実行中、失敗、タイムアウト、停止）、最大件数に対して返された結果数、課金額、実行 ID が表示されます。実行中のものには、課金額の代わりに仮押さえされている金額が表示されます。ブラウザエージェントの実行もここに表示されます。
同じ一覧は API からも取得できます。
curl "https://lovelyrouter.com/v1/tools/runs?limit=20" \
-H "Authorization: Bearer $LOVELY_API_KEY"各実行には charge_usd（精算されるまでは null）と reserved_usd（実行中の仮押さえ額）があります。ツールを実行するを参照してください。
ブラウザ実行#
ブラウザエージェントの履歴タブには、直近 50 件の実行が、ステータス、目標、ステップ数、開始時刻とともに表示されます。いずれかをクリックすると、そのステップ、回答、抽出されたデータを確認できます。API からは GET /v1/browser/runs を、1 件の実行を課金額付きで取得するには GET /v1/browser/runs/{id} を呼び出します。ブラウザエージェントを参照してください。
課金額を照合する#
残高が動く理由は 2 つです。クレジットで増え、利用で減ります。
- クレジット：チャージ、引き換えたコード、紹介報酬、無料クレジット。請求のチャージ履歴に表示されます。
- 利用：ログのモデルのリクエストと、ツールのツール実行・ブラウザ実行。
- 仮押さえ：進行中の実行は、精算されるまで最大費用を仮押さえし、精算後に使わなかった分を解放します。
1 つのキーを確認するには、API キーのそのキーの利用額列（モデルのリクエスト、ツールの実行、ブラウザ実行を含む）を、ログ内のそのキーのリクエストと比較します。
小さな差が生じる主な理由：
- 精算には数秒かかります。 課金はリクエストの完了から数秒以内に記録されるため、トラフィックが多いときに集計した合計はわずかに遅れることがあります。
- キャンセルしたストリームは、処理された分が課金されます。 最後の usage イベントの前にストリームを閉じた場合、出力はすでに送信されたテキストからの推定値で課金されます。ストリーミングを参照してください。
- 請求額の列が正式な値です。 これはそのリクエストについて残高から差し引かれた金額です。トークンあたりの価格はモデル一覧で確認できます。
サポートに問い合わせる#
ダッシュボードのサポートを開き、新しい問い合わせをクリックします。特定の呼び出しについての質問であれば、リクエスト ID（req_…）または実行 ID（run_…、brun_…）を添えてください。ログの行からこのリクエストについてサポートに問い合わせるを使うと、ID が自動で入力されます。返信は同じページに表示され、新しい返信があるとサイドバーのサポートの項目にバッジが付きます。問い合わせに返信して詳細を追加することも、解決済みにすることもできます。