> 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 Dashboardがタブとして開きます。

{% 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](#credit-consumption-audit-log)
3. 現在のPlan Cycle

{% 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-chart)
* [Usage Projection](#usage-projection)
* [Current Cycle Breakdown](#current-cycle-breakdown)
* [Credit Consumption Audit Log](#credit-consumption-audit-log)

### Usage Chart

<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>

ワークスペースのクレジット使用状況をより深く理解するために、Usage Chart内にはいくつかの機能があります:（番号は上の画像のラベルに対応しています）

#### 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. 日付範囲

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

#### 3. フィルター

「Attribution」フィルターおよび/または「Usage Type」フィルターを選択できます

<details>

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

Attributionフィルターでは、Roboflow内のAPIキーまたはフォルダに帰属する使用状況で絞り込むことができます。\
\
これにより、特定のチーム、グループ、部門に割り当てられるフォルダ、または特定のユースケース、デバイス、デプロイに割り当てられる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. 表示モード

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

### Usage Projection

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

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

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

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

「Customize Assumptions」をクリックするとScenario Builderが開き、以下が可能です:

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

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

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

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

### Current Cycle Breakdown

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」を展開すると、特定のモデルタイプ、エポック数、データセット形状に対して、学習ジョブにどれくらい時間がかかり、何クレジット必要かを予測できます。

### Credit Consumption Audit Log

クレジットの詳細な使用状況を確認したい場合は、上部の「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>

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

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

<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>

## 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アプリの請求使用レポート](https://app.roboflow.com/) を駆動するのと同じJSONです。- 月初来の画像アップロード数、消費された学習クレジット、ホスト/専用推論の件数。

## HTTP API

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

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

こちらを参照 [Billing Folders Usage Report](/get-started/ja/purattofmu/billing-and-plans/billing-folders.md#http-api) 生のRESTエンドポイントについてはこちら。

## CLI

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