Skip to content

利用とコスト ​

使用量と費用タブには、このプロジェクトが行った請求対象のモデルAPIコール(その後破棄された再試行も含む)が、トークン数と単一のUSDコストで集計されて表示されます。

同じ集計結果はコマンドラインで ai-i18n-tools usage として利用できます。

これを使って、何回の呼び出しを行ったか、どのモデルと操作がトークンを消費したか、そしてコストはいくらだったか という疑問に答えることができます。

記録される内容 ​

各詳細行は、使用量を返した 1 つの HTTP 完了です(後にパースやスクリプト、品質の理由で翻訳が拒否され、次のフォールバックモデルが試行された場合も含みます)。課金対象のレスポンスボディを生成しなかった通信の失敗は記録されません。

APIを呼び出すコマンドが完了した後、UTC暦日での丸7日間(本日の7日前のUTC 00:00起算)より古い行は月次合計(api_totals)に集約され、詳細ログから削除されます。直近1週間は個別のapi_calls行として保持されます。サマリーテーブルは、選択した期間について両方のソースを組み合わせて表示します。

コスト報告 ​

各呼び出し、サマリーカード、およびテーブルには1つのUSDコストが表示されます。

  1. レスポンスに usage.cost が含まれている場合のプロバイダーの(現在は OpenRouter および Cheaper Inference)。0 を含む報告されたコストは、決して置き換えられません。
  2. それ以外の場合は、providers.<name>.modelPricing またはプロバイダー全体の pricing デフォルトから取得した金額が、その呼び出しの入力トークンおよび出力トークンに適用されます。
  3. それ以外の場合は、同じキャッシュ suggest-models が保持している、そのモデル ID の models.dev 定価(100万トークンあたりの入力および出力 USD)が適用されます。suggest-models --refresh がそのキャッシュを更新します。翻訳やこのレポートでは、呼び出しの価格設定のみを目的として languagebench や Arena をダウンロードすることはありません。

新しい呼び出しは、その金額を api_calls 行に保存します。コストなしで保存された古い行は、レポートを開いたときに同じ方法で価格が算出され、同じ「コスト」数値に追加されます。これらは 2 列目として表示されることはありません。3 つのソースのいずれも適用されない場合、セルは — となり、$0.00 になることはありません。設定されたレートを変更したり、後で models.dev を更新したりしても、すでにコストが保存されている行が書き換えられることはありません。月次のロールアップでは、コストが保存された呼び出しのカウント(ncost_acc / ncost_dis)が保持されるため、コンパクション後も $0.00 は「不明」とは区別されたままになります。

フィルター ​

期間、プロバイダー、モデル、操作(translate-docs, translate-ui, translate-json, translate-svg, proofread-ui, bench-models)、ロケール、および結果(採用 vs 破棄)でフィルターします。

期間:

  • 短い範囲(Last 30 minutes から Last 30 days)はローリング期間を使用します。Usage over time はその範囲内に詳細が残っている各 UTC 暦日につき 1 行を表示します。
  • Last 2 months / Last 3 months は現在の暦月の初日の 00:00 UTC から 1 / 2 か月前を開始とします。Usage over time は保持された日次行に加えて各月につき 1 行を表示します。
  • All time にはすべての月次合計と保持された日次行が含まれます。

古い使用量を削除するには、これより古いエントリを削除(> 1 month、> 2 months、> 3 months、> 6 months、> 1 year、またはall data (clear))から期間を選択し、データを削除をクリックします。メニューの初期値は-であり、期間が選択されるまでデータを削除は無効のままです。同じ期間をai-i18n-tools usage --clear [--older-than 1mo|2mo|3mo|6mo|1y|all]として利用できます。暦月のカットオフでは、当月(1mo)または当月とそれ以前の月が保持されます。

コマンドライン ​

bash
ai-i18n-tools usage
# ai-i18n-tools usage --since 7d --operation translate-docs
# ai-i18n-tools usage --since 2mo
# ai-i18n-tools usage --clear --older-than 3mo --dry-run

MITライセンスの下で公開されています。