> 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 Agent](/get-started/ja/jento/roboflow-agent.md) チャットで利用に関する質問をすることもできます（例：「このサイクルで何クレジット使いましたか？」や「APIキー別に過去30日間の使用状況を表示して」）。すると、関連するフィルターが適用された状態で Credit Usage ダッシュボードがタブとして開きます。

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

<figure><img src="https://2537277549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-68ae7fc4d27e2db473aa61e36cb1aa62c0925e65%2Fimage%20(446).png?alt=media" 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 の利用分はプランの請求とは別の間隔で請求されます。詳しくは、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="https://2537277549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-f7001a03a9914b0255e735d6c4c9ef1d1367541a%2Fimage%20(450).png?alt=media" alt=""><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://2537277549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-29c785252356811d29c621d37b056c4ae9901bf8%2Fimage%20(448).png?alt=media" alt="" width="188"><figcaption></figcaption></figure>

#### 2. 日付範囲

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

#### 3. フィルター

「Attribution」フィルターや「Usage Type」フィルターを選択できます

<details>

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

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

<figure><img src="https://2537277549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-82e8264fc5ab610b84b1cc0ca783e4c805938b91%2Fimage%20(451).png?alt=media" alt="" width="258"><figcaption></figcaption></figure>

**Billing Folders**

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

* フォルダを展開・折りたたみして、サブフォルダの使用状況を掘り下げる
* フォルダを選択または選択解除して、使用状況チャートを絞り込む

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

<figure><img src="https://2537277549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-b44af8827df1be86ba085c080bb8af5065d71111%2Fimage%20(454).png?alt=media" 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>

使用状況を、異なるカテゴリやクレジット使用のある特定の機能で絞り込めます。ドロップダウンをクリックすると、より細かなオプションが表示されます。\
\
![](https://2537277549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-78ec5570350a56163d0abba324966b5044529674%2Fimage%20\(452\).png?alt=media)

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

</details>

#### 4. 表示モード

ワークスペースのクレジット単価（ワークスペース、プラン、個別契約により異なる場合があります）に応じて、Credits（デフォルト）または Dollars のどちらかで表示できます

### 使用状況予測

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

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

* **予測クレジット使用量** 消費見込みのクレジット合計
* **予測される追加クレジット** 使用量が含まれているクレジットを超える可能性がある場合に警告します

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

「Customize Assumptions」をクリックすると Scenario Builder が開き、次のことができます：

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

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

#### 予測の保存、共有、公開

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

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

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

<figure><img src="https://2537277549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-e25fb0a179c44021fbc1955dae6dfd3189905b09%2Fimage%20(388).png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="https://2537277549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-18224adabfbd7bbe33a7d13af7ff39a4b8cf1988%2Fimage%20(389).png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

ページ下部では、次の項目について Workspace Limits まであとどれくらいかを確認できます：

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

<figure><img src="https://2537277549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-1a2329baebe5168085f592ff1ce790e47b48d42e%2Fimage%20(390).png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

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

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

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

<figure><img src="https://2537277549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-62cc16b49e586a8d64de0eabd86d19a35ee174a2%2Fimage%20(445).png?alt=media" alt="" width="375"><figcaption></figcaption></figure>

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

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

<figure><img src="https://2537277549-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-d323bb1d0720ded4426b6a7aaa1318532c57d6f1%2Fimage%20(444).png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

## Cloud Streaming の使用状況

については [Cloud Streaming](https://docs.roboflow.com/deployment/roboflow-cloud/cloud-streaming)、日付範囲と Usage Type フィルターを使って処理消費量を確認し、利用可能な場合は APIキーの属性も確認します。機能は、使用実績が記録された後にのみフィルターに表示されます。

ストリームの詳細ページに表示される時間単価は、累積または過去の支出ではなく、現在の割り当てレートです。プレビュー処理やテスト処理は、インターフェースに価格が表示されない場合でも使用量に含まれることがあります。 [Cloud Streaming の料金と制限](https://docs.roboflow.com/deployment/roboflow-cloud/cloud-streaming/pricing-and-limits) を参照してから、継続的なコストを見積もってください。

## 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", {}))   # 画像 / 推論 / トレーニングの含有枠
```

### 使用状況を取得

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

このレスポンスは、ワークスペースの [Webアプリの請求使用状況レポートを駆動しているのと同じ 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
```
