# Billing Folders

{% hint style="info" %}
Billing Folders는 **프리미엄** Enterprise 요금제에서 사용할 수 있는 기능입니다. Workspace에서 Billing Folders를 활성화하려면 [Roboflow 영업팀에 문의하거나](https://roboflow.com/sales) 또는 계정 담당자에게 문의하세요. 사용 가능한 요금제에 대한 자세한 내용은 다음을 방문하세요. [요금 페이지](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 %}

#### 이미지 저장소 할당

이미지 storage는 이미지를 참조하는 project가 포함된 folder에 할당됩니다.

같은 folder 내의 여러 project 또는 같은 상위 folder의 하위 folder들에 걸쳐 이미지가 공유되는 경우, storage는 해당 이미지를 사용하는 모든 project를 포함하는 가장 깊은 folder에 할당됩니다:

```
Workspace
├── Folder A
│   ├── Project 1  ← image.jpg
│   └── Project 2  ← image.jpg (공유됨)
└── Folder B
    └── Project 3

image.jpg storage는 Folder A에 할당됩니다(이를 참조하는 모든 project를 포함하는 가장 깊은 folder)
```

공통 상위 folder가 없는 서로 다른 root folder의 project들 사이에서 이미지가 공유되는 경우, storage는 workspace 수준에서 할당됩니다:

```
Workspace
├── Folder A
│   └── Project 1  ← image.jpg
└── Folder B
    └── Project 2  ← image.jpg (공유됨)

image.jpg storage는 Workspace에 할당됩니다(하나의 folder에 두 project가 모두 포함되지 않음)
```

### 사용량 보기

workspace의 credit usage 페이지에서 folder별로 세분화된 사용량을 포함해 확인할 수 있으며, 할당 필터를 **Folders**. Learn [billing folder로 사용량을 필터링하는 방법](/roboflow/roboflow-ko/billing/credits/view-credit-usage.md#attribution-filter-track-workspace-usage-for-a-given-folder-or-api-key) 또는 [일반적으로 사용량을 확인하는 방법을 알아보세요.](/roboflow/roboflow-ko/billing/credits/view-credit-usage.md)

### Folder 사용량 일시 중지 및 재개

Workspace 관리자는 folder 내의 모든 과금 대상 사용량을 일시적으로 중지할 수 있습니다. 이는 비용을 제어하거나 실수로 발생하는 사용량을 방지하는 데 유용합니다.

#### Folder 일시 중지

folder를 일시 중지하려면 **Folder Settings** 모달을 열고 다음을 토글하세요. **Pause Folder Usage**.

<figure><img src="/files/2be3362a97b44f283c83ed6883b645f6e9ed9749" alt=""><figcaption></figcaption></figure>

<div><figure><img src="/files/1e38198111d5e63c6c5b1571148a945d28568881" alt=""><figcaption></figcaption></figure> <figure><img src="/files/e80947811ef79483da50ed7da2ee6cda58b4a593" 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 Key

Billing Folders가 활성화되면 각 folder는 자동으로 고유한 API key를 받습니다. 이러한 key는 어떤 folder에 과금 대상 사용량이 속하는지 내부적으로 추적하는 데 사용됩니다.

* **키 보기**: Folder Settings 모달을 열고 API Keys 탭으로 이동하여 folder에 연결된 API key를 확인하세요.
* **자동 생성**: API key는 folder가 생성되거나 workspace에서 Billing Folders가 처음 활성화될 때 자동으로 생성됩니다. 수동으로 생성할 필요가 없습니다.

### 일반적인 시나리오

| Scenario                   | 발생하는 일                                                                                                    |
| -------------------------- | --------------------------------------------------------------------------------------------------------- |
| **project를 다른 folder로 이동** | 해당 project의 향후 사용량은 새 folder에 할당됩니다. 과거 사용량은 원래 folder에 계속 할당됩니다.                                         |
| **folder 삭제**              | folder가 workspace에서 제거됩니다. 하위 project와 sub-folder는 parent folder로 재할당됩니다. 과거 사용량 데이터는 billing 보고서에 보존됩니다. |
| **새 folder 생성**            | 새 folder에는 billing 할당을 위한 API key가 자동으로 제공됩니다. 추가 설정은 필요하지 않습니다.                                          |
| **Billing Folders 비활성화**   | folder 수준 할당이 중지됩니다. 새로운 사용량은 workspace 수준에서만 추적됩니다. folder billing 기간의 과거 사용량 데이터는 보존됩니다.                |

### Usage Report API

다음을 사용하여 프로그래밍 방식으로 billing usage 데이터를 조회할 수 있습니다. [billing usage report REST API](/developer/rest-api/billing-folders-usage-report.md).


---

# Agent Instructions: 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-ko/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.