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

有効にすると、すべての usage（例: training, inference, image storage, labeling など）は、使用中の Project を含むフォルダに自動的に帰属します。これにより、組織はチーム、部署、クライアントをまたいで、きめ細かなコストの可視化と支出管理を行えます。

### Usage Attribution の仕組み

Billing Folders が有効な場合、workspace 内の各フォルダにはそれぞれ独自の API key が付与されます。フォルダ内の Project で発生したすべての課金対象 usage は、そのフォルダの API key に対して追跡されます。つまり、usage reports と dashboard で各フォルダがどれだけ消費しているかを正確に確認できます。

{% hint style="info" %}
使用状況の帰属は自動です。usage を手動でフォルダに割り当てる必要はありません。Project から親フォルダへ流れます。
{% endhint %}

#### API または Deployment の使用状況

API key を使用して Roboflow のサービス（Serverless API、Batch Processing などを含むが、これらに限定されません）を利用する場合、課金の帰属はリクエスト内の API key に従い、Project のフォルダではありません。

workspace レベルの API key で行われた request は、その model がフォルダ内の Project に属していても workspace に帰属します。直接の API または batch usage をフォルダに帰属させるには、そのフォルダの API key で request してください。

#### Image Storage の帰属

Image storage は、その image を参照している Project を含むフォルダに帰属します。

同じフォルダ内の複数の Project（または同じ親のサブフォルダ内）で image が共有されている場合、storage は、その image を使用しているすべての Project を含む最も深いフォルダに帰属します：

```
Workspace
├── フォルダ A
│   ├── Project 1  ← image.jpg
│   └── Project 2  ← image.jpg (shared)
└── フォルダ B
    └── Project 3

image.jpg の storage はフォルダ A に帰属します（それを参照するすべての Project を含む最も深いフォルダ）
```

異なるルートフォルダの Project 間で共有され、共通の親フォルダがない image の場合、storage は workspace レベルに帰属します：

```
Workspace
├── フォルダ A
│   └── Project 1  ← image.jpg
└── フォルダ B
    └── Project 2  ← image.jpg (shared)

image.jpg の storage は Workspace に帰属します（両方の Project を含む単一のフォルダがないため）
```

### 使用状況の表示

workspace の credit usage page で、フォルダ別の内訳を含む usage を確認でき、帰属フィルターを **Folders**. 詳しくは [billing folder に usage をフィルタリングする方法](/roboflow/roboflow-jp/billing/credits/view-credit-usage.md#attribution-filter-track-workspace-usage-for-a-given-folder-or-api-key) または [usage を一般的に表示する方法。](/roboflow/roboflow-jp/billing/credits/view-credit-usage.md)

### フォルダ usage の一時停止と再開

workspace administrators は、フォルダ内のすべての課金対象 usage を一時的に停止できます。これは、コストの管理や誤操作による usage の発生を防ぐのに役立ちます。

#### フォルダを一時停止する

フォルダを一時停止するには、 **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 が無効になります
* そのフォルダに対して usage が発生する API request は、 `423 Locked` ステータスコードで拒否されます
* そのフォルダには新しい課金対象 usage は記録されません

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

#### フォルダを再開する

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

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

### Folder API Keys

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

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

### よくあるシナリオ

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

### Usage Report API

billing usage data は、以下を使用してプログラムから照会できます。 [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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.