> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/get-started/ja/purattofmu/billing-and-plans/credits/view-credit-usage.md).

# クレジット使用量を表示

Credit Usageページでは、クレジットをどのように使ったか、いつ使ったか、過去の使用パターンを確認できます。また、 [Roboflowエージェント](/get-started/ja/jento/agents/roboflow-agent.md) チャットで使用状況に関する質問ができます（例：「このサイクルで何クレジット使いましたか？」や「APIキーごとに直近30日間の使用状況を表示してください」）。すると、関連するフィルターが適用された状態で Credit Usage Dashboard がタブとして開きます。

{% hint style="info" %}
Credit Usageページには、Workspace Settings >「Credit Usage」からアクセスできます
{% endhint %}

<figure><img src="/files/8dfcf8ea0f5cb041011c00702dfbadb1507bb0ab" alt="" width="563"><figcaption></figcaption></figure>

上部には次の項目があります：

1. 説明ページへのリンク [Roboflow内でクレジットがどのように機能するか](/get-started/ja/purattofmu/billing-and-plans/credits.md)
2. 次のボタン： [クレジット消費監査ログ](#credit-consumption-audit-log)
3. 現在のプランサイクル

{% hint style="info" %}
年間プランを含む一部のワークスペースには「Flex Cycle」があり、これは Flex Usage の請求がプランの請求とは別の間隔で行われることを意味します。詳細は [Creditsページの Flex Usage セクションをご覧ください](/get-started/ja/purattofmu/billing-and-plans/credits.md#flex-usage).
{% endhint %}

ワークスペースのクレジット使用状況を把握するために使える主なツールは4つあります：

* [使用状況チャート](#usage-chart)
* [使用状況予測](#usage-projection)
* [現在のサイクル内訳](#current-cycle-breakdown)
* [クレジット消費監査ログ](#credit-consumption-audit-log)

### 使用状況チャート

<figure><img src="/files/c55cff92763bd00742c3e11cfb4d6cba6f1a16a7" alt=""><figcaption></figcaption></figure>

使用状況チャートには、ワークスペースのクレジット使用状況をより深く把握するために使える機能がいくつかあります：（数字は上の画像のラベルに対応します）

#### 1. 累積モード切り替え

デフォルトでは、チャートはクレジット使用量を累積表示するように設定されています。これは、チャート上の「棒」がサイクル内で使用したクレジットを表すことを意味します。たとえば、一番右の「棒」が15クレジットを示している場合、このサイクルで15クレジットを使用したことになります。\
\
これをオフにすると、1日ごとのクレジット使用量が表示されるため、下の画像のように、最も多くクレジットを使用した日の急増を把握しやすくなります：<br>

<figure><img src="/files/ac34f68079a7c30b81f27bed6af63d9b0f34089c" alt="" width="188"><figcaption></figcaption></figure>

#### 2. 日付範囲

プランサイクル（ワークスペースのプラン請求／含まれる上限のサイクル）または日付範囲で選択できます

#### 3. フィルター

「Attribution」フィルターと／または「Usage Type」フィルターを選択できます

<details>

<summary><strong>Attributionフィルター：</strong> 特定のフォルダまたはAPIキーのワークスペース使用状況を追跡</summary>

Attribution フィルターでは、Roboflow 内の API キーまたはフォルダに帰属する使用状況で絞り込めます。\
\
これにより、特定のチーム、グループ、部門に割り当てられるフォルダごとのワークスペース使用状況や、特定のユースケース、デバイス、デプロイに割り当てられる特定のAPIキーごとの使用状況を追跡できます。\
\
**APIキーによるフィルタリング**<br>

<figure><img src="/files/c182932d144be9251639af6cc1d6976061838a1d" alt="" width="258"><figcaption></figcaption></figure>

**請求フォルダ**

これは、各フォルダの使用データを含むワークスペースのフォルダ構造を階層ツリービューで表示します。次のことができます：

* フォルダを展開・折りたたんでサブフォルダの使用状況を詳しく確認する
* フォルダを選択／選択解除して使用状況チャートを絞り込む

使用量はデフォルトで集計表示されます。親フォルダの選択を解除すると、そのフォルダの直接の使用量をチャートから除外し、子フォルダの使用量のみを表示できます。

<figure><img src="/files/dfaafc32d6b44b425c929a243dc62a69b179312b" alt="" width="358"><figcaption></figcaption></figure>

{% hint style="info" %}
Billing Folders はプレミアム機能です。詳細はこちら [こちら](/get-started/ja/purattofmu/billing-and-plans/billing-folders.md)
{% endhint %}

</details>

<details>

<summary><strong>Usage Typeフィルター：</strong> 使用状況の異なるカテゴリや特定の機能で絞り込む</summary>

クレジットを使用しているカテゴリや特定の機能に使用状況を絞り込めます。プルダウンをクリックすると、さらに細かいオプションが表示されます。\
\
![](/files/5a889ddc410c62f7d3f1d6abcd5c1c3f3aabbaf2)

{% hint style="info" %}
このフィルターには、クレジット使用があったカテゴリと機能のみが表示されます。
{% endhint %}

</details>

#### 4. 表示モード

Credits（デフォルト）または Dollars のいずれかで表示できます。これは、ワークスペースの1クレジットあたりの価格によって異なります（価格はワークスペース、プラン、個別契約によって異なる場合があります）

### 使用状況予測

「Projection」タブでは、最近のアクティビティに基づいて将来のクレジット使用量を予測できます。

Projectionタブを開くと、次の項目が表示されます：

* **予測クレジット使用量** 消費見込みのクレジット総数
* **予測追加クレジット** 使用量が含まれるクレジットを超過しそうな場合に警告します

#### 予測をカスタマイズ

「Customize Assumptions」をクリックして Scenario Builder を開き、次の操作ができます：

* **予測期間を設定する** 現在のサイクル終了、次のサイクル終了、3か月、1年、またはカスタム日付に設定する
* **基準期間を変更する** どの過去の使用データを予測に反映するかを制御する
* **機能ごとの使用率を調整する** 「もしも」のシナリオをモデル化するため（たとえば、推論量の増加や新機能の追加）

現在のレートをもとにシナリオを作成したり、個別機能のレートをカスタマイズしたり、ゼロから始めたりできます。

#### 予測を保存・共有・公開する

予測を将来の参照用に保存したり、リンクでチームメイトと共有したり、公開したりできます。保存した予測は Projection タブからアクセスでき、カスタムした前提条件はすべて保持されます。

### 現在のサイクル内訳

Current Cycle Breakdown では、現在の請求サイクルのクレジット支出の概要を確認できます。

<figure><img src="/files/9f5585b9586a9f60373c506ddfa48eedb948c8d8" alt="" width="563"><figcaption></figcaption></figure>

現在の請求サイクルで使用したクレジットの内訳を、機能別にまとめ、Dataset、Train、Deploy に分けて確認できます

<figure><img src="/files/d4ad519bb8004a3e3cad7b6f6701815a93268795" alt="" width="563"><figcaption></figcaption></figure>

ページ下部では、以下のワークスペース上限にどれだけ近づいているかを確認できます：

* チームメンバー
* プロジェクト

<figure><img src="/files/22adb84f0a4242874313141d2a95ec62461a3175" alt="" width="563"><figcaption></figcaption></figure>

ページ下部で「Training Cost Estimator」を展開すると、特定のモデルタイプ、エポック数、データセット形状に対して、学習ジョブにかかる時間と必要クレジット数を予測できます。

### クレジット消費監査ログ

クレジットの詳細な使用状況を確認したい場合は、上部の「Audit Log」をクリックしてください。

<figure><img src="/files/2a01591c7232875ceee0cb522bc788852a628707" alt="" width="375"><figcaption></figcaption></figure>

この画面で、表示したい日付範囲を選択し、Search をクリックします。

この表示では、クレジット使用に関連する正確な機能とタイムスタンプが表示され、どの操作がクレジットを消費しているのかをより把握しやすくなります。

<figure><img src="/files/64943bb7c462548f52597b4cc04b5bd96ad18107" alt="" width="563"><figcaption></figcaption></figure>

## Python SDK

`Workspace.get_plan()` ワークスペースの請求プラン、含まれるクレジット、および機能上限を返します。 `Workspace.get_usage()` 対応する使用レポート（推論呼び出し、学習クレジット、画像数）を返します。

これらは、社内ツールに請求ダッシュボードを組み込んだり、有料クレジットを消費する自動処理にガードレールを設けたりするのに役立ちます。

### プランを取得

```python
import roboflow

rf = roboflow.Roboflow(api_key="YOUR_API_KEY")
workspace = rf.workspace()

plan = workspace.get_plan()
print(plan["name"])             # 例: "growth"
print(plan.get("limits", {}))   # 含まれる image / inference / training の上限
```

### 使用状況を取得

```python
usage = workspace.get_usage()
print(usage)
```

返される内容は、ワークスペースの [web app における請求使用状況レポートを生成するのと同じ JSON です](https://app.roboflow.com/) ・月初来の画像アップロード数、消費した学習クレジット数、ホスト型／専用推論の回数。

## HTTP API

同じデータは次の場所でも公開されています：

* `GET /usage/plan` ・プラン情報
* `POST /:workspace/billing-usage-report` ・使用状況の内訳

参照 [Billing Folders 使用状況レポート](/get-started/ja/purattofmu/billing-and-plans/billing-folders.md#http-api) 生の REST エンドポイントについて。

## CLI

```bash
roboflow workspace plan
roboflow workspace usage
```