> 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/roboflow/roboflow-jp/workspaces/billing-folders.md).

# Billing Folders

{% hint style="info" %}
Billing Folders は **premium** Enterpriseプランで利用できる機能です。ワークスペースでBilling Foldersを有効にするには、 [Roboflowの営業チーム](https://roboflow.com/sales) またはアカウント担当者にお問い合わせください。利用可能なプランの詳細については、 [料金ページをご覧ください](https://roboflow.com/pricing).
{% endhint %}

有効にすると、すべての使用量（例: 学習、推論、画像ストレージ、ラベリングなど）は、使用中のプロジェクトを含むフォルダに自動的に割り当てられます。これにより、組織はチーム、部門、またはクライアント全体で、きめ細かなコストの可視化と支出管理を行えます。

### 使用量の割り当ての仕組み

Billing Foldersが有効な場合、ワークスペース内の各フォルダには独自のAPIキーが付与されます。フォルダ内のプロジェクトで発生した請求対象の使用量はすべて、そのフォルダのAPIキーに対して追跡されます。つまり、各フォルダがどれだけ消費しているかを、使用量レポートとダッシュボードで正確に確認できます。

{% hint style="info" %}
使用量の割り当ては自動です。使用量をフォルダに手動で割り当てる必要はありません。プロジェクトから親フォルダへと引き継がれます。
{% endhint %}

#### APIまたはデプロイメントの使用量

APIキーを使用してRoboflowのサービスを利用する場合（Serverless API、Batch Processingなどを含むがこれらに限定されません）、請求の割り当てはプロジェクトのフォルダではなく、リクエスト内のAPIキーに従います。

workspaceレベルのAPIキーで行われたリクエストは、使用されたモデルがフォルダ内のプロジェクトに属していても、workspaceに割り当てられます。直接のAPI使用量やバッチ使用量をフォルダに割り当てるには、そのフォルダのAPIキーでリクエストしてください。

#### 画像ストレージの割り当て

画像ストレージは、その画像を参照するプロジェクトを含むフォルダに割り当てられます。

同じフォルダ内の複数のプロジェクト、または同じ親を持つサブフォルダ内で画像が共有されている場合、ストレージはその画像を使用するすべてのプロジェクトを含む、最も深いフォルダに割り当てられます:

```
Workspace
├── フォルダA
│   ├── プロジェクト1  ← image.jpg
│   └── プロジェクト2  ← image.jpg（共有）
└── フォルダB
    └── プロジェクト3

image.jpgのストレージはフォルダAに割り当てられます（それを参照するすべてのプロジェクトを含む最も深いフォルダ）
```

共通の親フォルダを持たない異なるルートフォルダ間で画像が共有されている場合、ストレージはworkspaceレベルで割り当てられます:

```
Workspace
├── フォルダA
│   └── プロジェクト1  ← image.jpg
└── フォルダB
    └── プロジェクト2  ← image.jpg（共有）

image.jpgのストレージはworkspaceに割り当てられます（両方のプロジェクトを含む単一のフォルダがないため）
```

### 使用量の表示

workspaceのクレジット使用量ページで、フォルダ別の内訳を含む使用量を確認でき、割り当てフィルターを **Folders**に切り替えられます。 [Billing folderへの使用量のフィルタリング方法](/roboflow/roboflow-jp/billing/credits/view-credit-usage.md#attribution-filter-track-workspace-usage-for-a-given-folder-or-api-key) または [使用量の一般的な表示方法](/roboflow/roboflow-jp/billing/credits/view-credit-usage.md)

### フォルダ使用量の一時停止と再開

workspace管理者は、フォルダ内のすべての請求対象使用量を一時的に停止できます。これは、コスト管理や誤った使用の防止に役立ちます。

#### フォルダの一時停止

フォルダを一時停止するには、 **Folder Settings** モーダルを開き、 **Pause Folder Usage**.

<figure><img src="/files/185c610462111272cebfb09a184d6b09ddb61ac6" alt=""><figcaption></figcaption></figure>

<div><figure><img src="/files/6a01c3aefbe283e28aacf9dff94e727716421906" alt=""><figcaption></figcaption></figure> <figure><img src="/files/5b744bd6b9db7db2640dae2a29e36df2235b4698" alt=""><figcaption></figcaption></figure></div>

フォルダが一時停止されると:

* そのフォルダに属するすべてのAPIキーが無効になります
* そのフォルダに対して使用量が発生するAPIリクエストは、 `423 Locked` ステータスコードで拒否されます
* そのフォルダには新しい請求対象使用量は記録されません

Pause All Descendant Folders' Usage を切り替えることで、フォルダとそのすべての子孫フォルダの使用量をまとめて一時停止することもできます。これにより、選択したフォルダとその下にネストされたすべてのフォルダのAPIキーが無効になります。

#### フォルダの再開

一時停止したフォルダを再開するには、「Folder Settings」モーダルに戻り、一時停止コントロールをオフにします。これにより、そのフォルダのAPIキーが再び有効になり、通常の動作が復元されます。同様に、フォルダとそのすべての子孫をまとめて再開することもできます。

再開の影響を受けるのは、フォルダの一時停止機能によって停止されたキーのみです。別の理由で無効化されたキーは影響を受けません。

### フォルダのAPIキー

Billing Foldersが有効な場合、各フォルダには自動的に独自のAPIキーが付与されます。これらのキーは、請求対象の使用量がどのフォルダに属するかを追跡するために内部で使用されます。

* **キーの表示**: Folder Settingsモーダルを開き、API Keysタブに移動すると、フォルダに関連付けられたAPIキーを確認できます。
* **自動作成**: フォルダが作成されたとき、またはworkspaceでBilling Foldersが初めて有効になったときに、APIキーは自動的に作成されます。手動で作成する必要はありません。

### 一般的なシナリオ

| シナリオ                      | 発生する内容                                                                         |
| ------------------------- | ------------------------------------------------------------------------------ |
| **プロジェクトを別のフォルダに移動する**    | そのプロジェクトの今後の使用量は、新しいフォルダに割り当てられます。過去の使用量は元のフォルダに割り当てられたままです。                   |
| **フォルダを削除する**             | フォルダはworkspaceから削除されます。子プロジェクトとサブフォルダは親フォルダに再割り当てされます。過去の使用量データは請求レポートに保持されます。 |
| **新しいフォルダを作成する**          | 新しいフォルダには、請求の割り当て用のAPIキーが自動的に付与されます。追加の設定は不要です。                                |
| **Billing Foldersを無効にする** | フォルダレベルの割り当ては停止します。新しい使用量はworkspaceレベルのみに記録されます。フォルダ請求期間の過去の使用量データは保持されます。     |

### Usage Report API

次のAPIを使用して、請求使用量データをプログラムから照会できます。 [billing usage report REST API](/developer/rest-api/billing-folders-usage-report.md).