# Billing Folders

{% hint style="info" %}
Billing Foldersは **プレミアム** Enterpriseプランで利用できる機能です。WorkspaceでBilling Foldersを有効にするには、 [Roboflow sales team](https://roboflow.com/sales) または担当アカウント担当者にお問い合わせください。利用可能なプランの詳細については、 [pricing page](https://roboflow.com/pricing).
{% endhint %}

有効にすると、すべての使用量（例: training、inference、image storage、labeling など）は、使用されているprojectを含むfolderに自動的に割り当てられます。これにより、組織はチーム、部門、または顧客をまたいで、きめ細かなコストの可視化と支出管理を行えます。

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

Billing Foldersが有効になると、workspace内の各folderにそれぞれ独自のAPI keyが付与されます。folder内のprojectで発生した請求対象の使用量は、そのfolderのAPI keyに対して追跡されます。つまり、usage reportsとdashboardで各folderがどれだけ消費しているかを正確に確認できます。

{% hint style="info" %}
使用量の割り当ては自動です。使用量をfolderに手動で割り当てる必要はありません。projectから親folderへと引き継がれます。
{% endhint %}

#### Image Storageの割り当て

image storageは、そのimageを参照しているprojectを含むfolderに割り当てられます。

同じfolder内の複数のproject、または同じ親を持つサブfolder内の複数のprojectでimageが共有されている場合、storageは、そのimageを使用しているすべてのprojectを含む最も深いfolderに割り当てられます:

```
Workspace
├── Folder A
│   ├── Project 1  ← image.jpg
│   └── Project 2  ← image.jpg (共有)
└── Folder B
    └── Project 3

image.jpg のstorageは Folder A に割り当てられます（それを参照するすべてのprojectを含む最も深いfolder）
```

異なるroot folder内のproject間で、共通の親folderなしにimageが共有されている場合、storageはworkspaceレベルで割り当てられます:

```
Workspace
├── Folder A
│   └── Project 1  ← image.jpg
└── Folder B
    └── Project 2  ← image.jpg (共有)

image.jpg のstorageは Workspace に割り当てられます（両方のprojectを含む単一のfolderがないため）
```

### 使用量の表示

workspaceのcredit usage pageでfolder別の内訳を含む使用量を確認でき、割り当てフィルターを **Folders**に切り替えられます。 [billing folderへの使用量のフィルター方法](https://docs.roboflow.com/roboflow/roboflow-jp/billing/credits/view-credit-usage#attribution-filter-track-workspace-usage-for-a-given-folder-or-api-key) または [使用量の一般的な表示方法をご確認ください。](https://docs.roboflow.com/roboflow/roboflow-jp/billing/credits/view-credit-usage)

### Folder使用量の一時停止と再開

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

#### Folderの一時停止

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

<figure><img src="https://3740591140-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2FvHVbd40PbMpjSIzCjbwZ%2FScreenshot%202026-04-02%20at%2010.13.20%E2%80%AFAM.png?alt=media&#x26;token=9857cd32-098b-43b1-98ac-4db6314aaa52" alt=""><figcaption></figcaption></figure>

<div><figure><img src="https://3740591140-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2FQ51dkevgpebWvBgu7ZLb%2FScreenshot%202026-04-02%20at%2010.15.56%E2%80%AFAM.png?alt=media&#x26;token=2c9ca32b-7cac-4bef-b0a1-c9226ccd3a90" alt=""><figcaption></figcaption></figure> <figure><img src="https://3740591140-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M6S9nPJhEX9FYH6clfW%2Fuploads%2FbVR6OKp0hfwVuvUq4Zys%2FScreenshot%202026-04-02%20at%2010.17.14%E2%80%AFAM.png?alt=media&#x26;token=6cd47df4-49c6-4651-b27f-4d5e96d7acb4" alt=""><figcaption></figcaption></figure></div>

を切り替えます。folderが一時停止されると:

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

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

#### Folderの再開

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

再開は、folderの一時停止機能によって停止されたkeyにのみ影響します。ほかの理由で無効化されたkeyには影響しません。

### Folder API Keys

Billing Foldersが有効になると、各folderに自動的に独自のAPI keyが付与されます。これらのkeyは、請求対象の使用量がどのfolderに属するかを内部的に追跡するために使用されます。

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

### 一般的なシナリオ

| シナリオ                      | 起こること                                                                                          |
| ------------------------- | ---------------------------------------------------------------------------------------------- |
| **projectを別のfolderに移動する** | そのprojectの今後の使用量は新しいfolderに割り当てられます。過去の使用量は元のfolderに割り当てられたままです。                               |
| **folderを削除する**           | folderはworkspaceから削除されます。子projectとサブfolderは親folderに再割り当てされます。過去の使用量データはbilling reportsに保持されます。 |
| **新しいfolderを作成する**        | 新しいfolderには、請求の割り当て用のAPI keyが自動的に付与されます。追加の設定は不要です。                                            |
| **Billing Foldersを無効化する** | folderレベルの割り当ては停止します。新しい使用量はworkspaceレベルでのみ追跡されます。folderのbilling期間中の過去の使用量データは保持されます。          |

### Usage Report API

次のものを使用して、請求の使用量データをプログラムから問い合わせできます: [billing usage report REST API](https://app.gitbook.com/s/e5GEiPeDoFksvZv1vH3A/rest-api/billing-folders-usage-report).