APIキー、クォータ、使用状況

このページでは、APIキーの設定、LLMクォータの計算方法、ログと統計による使用状況の確認方法を説明します。

#クォータの仕組み

• アカウントのクォータ：LLM APIを有効にすると、専用のLLMアカウントが作成され、モデルの利用料金がそこから差し引かれます。メインアカウントの残高とは別に管理されます。振替または引き換えコードで追加できます。アカウント概要の現在の残高には残額、累計使用量にはこれまでの利用額が表示されます。
• 表示金額：コンソールには、クォータが米ドル相当額で表示されます。キーの設定にクォータの値を直接入力する場合、500000 quota units = $1です。
• 料金：ほとんどのモデルは、入力トークンと出力トークンに別々の料金がかかります。回数課金と表示される一部のモデルは、呼び出しごとに課金されます。LLM API → モデルと料金には、各モデルの1K tokensあたりの入力料金と出力料金、および倍率が表示されます。グループによって料金倍率が適用される場合もあり、キー作成時のグループ選択肢に表示されます。

#APIキーを管理する

LLM API → トークン管理（/llm/tokens）を開きます。一覧には、キーごとに次の列が表示されます。

操作列では、スイッチでキーを有効または無効にし、編集アイコンで設定を変更し、削除アイコンで削除できます。削除したキーを使用するリクエストは、直ちに失敗するようになります。

#キーの設定項目

#セキュリティに関する推奨事項

• アプリケーションと環境ごとに別のキーを作成し、個別に無効化や監査ができるようにしてください。
• 外部公開アプリで使用するキーには、クォータ上限を設定してください。キーが漏えいしても、損失を上限内に抑えられます。
• サーバー側からの呼び出しには、可能な場合はIP制限を設定してください。
• キーはサーバー側だけで保持し、ブラウザーやモバイルアプリのコードには含めないでください。漏えいの疑いがある場合は、すぐに無効化または削除して、新しいキーを作成してください。

#クォータを追加する

• 振替：「アカウント概要」の「現在の残高」カードで振り替えをクリックし、メイン残高から資金を移します。最低額は1で、取得できるクォータの量がダイアログに表示されます。振替は取り消せません。
• 引き換えコード：「アカウント概要」の引き換えコードでチャージカードにコードを入力し、引き換えをクリックします。
• メイン残高にチャージ：「現在の残高」カードでチャージをクリックし、請求 → 残高に移動します。

#使用ログ

LLM API → リクエストログ（/llm/logs）には、すべての呼び出しとクォータの変更が記録されます。

• フィルター：期間、キー（トークン）名、モデル名、種類です。種類には、チャージ、利用額、管理、システム、エラーがあります。
• 列：時刻、キー、種類、モデル、処理時間と最初のトークンまでの時間、入力トークン数、出力トークン数、コスト、送信元IP、詳細です。リクエストしたモデルが別のモデルにマッピングされた場合は、リクエストしたモデルと実際のモデルの両方が表示されます。
• 集計：ページ上部には、総レコード数、成功したリクエスト数、失敗したリクエスト数など、現在のフィルター条件での集計が表示されます。

トラブルシューティングでは、まずエラーの種類で絞り込み、詳細のエラーメッセージを確認してください。

#使用統計

LLM API → 使用量（/llm/stats）には、指定期間の使用状況が集計されます。

• クォータの合計、使用済み、残り、使用率
• 選択した期間のリクエスト数、トークン数、利用額
• 使用量の推移グラフ、モデル別の利用額、リクエスト数によるモデルランキング
• 日付、モデル、リクエスト数、トークン数、使用クォータを含む日別の内訳テーブル

アカウント概要ページにも、期間内のリクエスト数、クォータ、トークン数と、選択した日付範囲での平均 RPM、TPM（1分あたりのトークン数）が簡潔に表示されます。