> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/jp/pre-basic/settings/usage.md).

# 使用量統計

使用量統計で、Cherry Studio 内の **モデル呼び出し状況を可視化ダッシュボードにまとめます**：いくら使ったか、何 Token 使ったか、何回リクエストしたか、どのモデルが最も使われたかが一目でわかります。コストの見積もり、異常な消費の発見、異なるモデルの使い分けの判断にも役立ちます。

有効にすると `設定 → 使用量統計`。ページは **概要 / 探索 / リクエスト** の3つの部分に分かれており、右上で切り替えできます **直近30日 / 直近90日 / 直近1年**を選べます。すべてのデータは選択した期間で集計されます。

<figure><img src="/files/bc00ddc5a6530983485bf61b0c87d52b9292cfdb" alt=""><figcaption><p>使用量統計【概要】：上部の指標カード + 下部の日別アクティビティヒートマップ（図中の総コストは非表示）</p></figcaption></figure>

### 概要

上部の指標カード群：

| 指標                   | 意味                                                     |
| -------------------- | ------------------------------------------------------ |
| **総コスト**             | 期間内の推定費用（各モデルの公開価格に基づく換算、参考値）                          |
| **リクエスト数**           | 発行されたリクエストの総回数                                         |
| **総 Token 数**        | 入力 + 出力の Token 総量                                      |
| **キャッシュヒット率**        | プロンプトキャッシュにヒットした割合（ヒットしたキャッシュ読み取り ÷ 可観測入力）。高いほど節約になります |
| **アクティブ日数 / 最長連続日数** | 使用記録がある日数と連続使用した日数                                     |
| **ピーク日**             | 単日使用量が最も多い日付とその Token 量                                |
| **使用量最多モデル**         | 期間内に最も消費したモデル                                          |
| **日平均**              | 1日あたりの平均 Token 量とリクエスト数                                |

下部の **日別アクティビティ** ヒートマップは日ごとの使用量の強さを表示し、 **Token / コスト** の2つの指標を切り替えられます。色が濃いほど、その日の使用量が多いことを示します。

### 探索 / 分析

に切り替えると **探索** では、使用量を分解して分析できます： **グループ**（プロバイダー / モデル / APIキー / アシスタント·Agent）で分け、1つを選んで **指標**、さらに **棒グラフ / 折れ線グラフ / 円グラフ / セグメント** などのチャートで分布と傾向を確認できます。

### リクエスト詳細

**リクエスト** 各リクエストを一覧表示し、どのリクエストが主な消費を生んだかを特定するのに便利です。

> 特定の日で見たいですか？概要の **日別アクティビティ** ヒートマップ上で任意の日をクリックすると、探索エリア（分析 + リクエスト）が **ドリルダウン** してその日の「明細」に変わります。［日付フィルターをクリア］を押すと戻れます。

{% hint style="info" %}
コストは **推定値**です：各モデルの公開価格に基づいて換算しており、実際の請求は各モデルサービス提供者の請求書に従います。無料モデル、ローカルモデルには費用は発生しません。
{% endhint %}

***

### ヘルプの取得とフィードバックの送信

設定または使用中に不明点、バグ、機能改善の提案がある場合は、 [フィードバックと提案](/docs/jp/question-contact/suggestions.md) に記載の公式チャネルをご参照ください。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/jp/pre-basic/settings/usage.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
