> 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 プランで利用できる機能です。Workspace で Billing Folders を有効にするには、 [Roboflow sales team](https://roboflow.com/sales) またはアカウント担当者にお問い合わせください。利用可能なプランの詳細は、 [料金ページ](https://roboflow.com/pricing).
{% endhint %}

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

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

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

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

#### API または Deployment の使用量

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

Workspace レベルの API key で行われたリクエストは、使用されるモデルがフォルダ内の project に属していても、Workspace に割り当てられます。直接 API または batch の使用量をフォルダに割り当てるには、そのフォルダの API key を使ってリクエストしてください。

#### 画像保存の割り当て

画像保存は、その画像を参照している project を含むフォルダに割り当てられます。

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

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

image.jpg の保存は Folder A に割り当てられます（これを参照するすべての project を含む最も深いフォルダ）
```

共通の親フォルダを持たない別々のルートフォルダの project 間で画像が共有されている場合、保存は Workspace レベルに割り当てられます:

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

image.jpg の保存は Workspace に割り当てられます（両方の project を含む単一のフォルダがないため）
```

### 使用量の表示

Workspace のクレジット使用量ページで、フォルダ別の内訳を含む使用量を確認でき、割り当てフィルターを **Folders**に切り替えられます。 [請求フォルダへの使用量のフィルタ方法](/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 key が無効になります
* そのフォルダに対して使用量が発生する API リクエストは、 `423 Locked` ステータスコードで拒否されます
* そのフォルダに対して新たな請求対象使用量は記録されません

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

#### フォルダの再開

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

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

### フォルダの API key

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

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

### 一般的なシナリオ

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

### Usage Report API

を使って、請求使用量データをプログラムでクエリできます。 [billing usage report REST API](/developer/rest-api/billing-folders-usage-report.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.roboflow.com/roboflow/roboflow-jp/workspaces/billing-folders.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.