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

# Billing Folders

{% hint style="info" %}
Billing Folders는 **프리미엄** Enterprise 플랜에서 사용할 수 있는 기능입니다. workspace에서 Billing Folders를 사용하도록 설정하려면 [Roboflow sales team](https://roboflow.com/sales) 또는 계정 담당자에게 문의하세요. 이용 가능한 플랜에 대한 자세한 내용은 다음을 방문하세요: [요금 페이지](https://roboflow.com/pricing).
{% endhint %}

활성화되면 모든 사용량(예: training, inference, 이미지 저장, labeling 등)이 사용 중인 project를 포함하는 folder에 자동으로 귀속됩니다. 이를 통해 조직은 팀, 부서 또는 고객 전반에 걸쳐 세부적인 비용 가시성과 지출 통제를 확보할 수 있습니다.

### Usage Attribution 작동 방식

Billing Folders가 활성화되면 workspace의 각 folder는 자체 API key를 받습니다. folder의 project 내에서 발생하는 모든 청구 대상 사용량은 해당 folder의 API key에 대해 추적됩니다. 즉, usage reports와 dashboard에서 각 folder가 얼마나 사용하고 있는지 정확히 확인할 수 있습니다.

{% hint style="info" %}
사용량 귀속은 자동으로 이루어집니다. 사용량을 folder에 수동으로 할당할 필요가 없습니다. 이는 project에서 상위 folder로 이어집니다.
{% endhint %}

#### API 또는 Deployment 사용량

API key를 사용해 Roboflow 서비스를 이용하는 경우(Serverless API, Batch Processing 등 포함하되 이에 국한되지 않음), 청구 귀속은 project의 folder가 아니라 요청에 사용된 API key를 따릅니다.

workspace 수준 API key로 보낸 요청은, 사용된 모델이 folder에 있는 project에 속하더라도 workspace에 귀속됩니다. 직접 API 또는 batch 사용량을 folder에 귀속시키려면 해당 folder의 API key로 요청하세요.

#### 이미지 저장소 귀속

이미지 저장소는 이미지를 참조하는 project(s)를 포함하는 folder에 귀속됩니다.

이미지가 동일한 folder 내의 여러 project(또는 동일한 상위 folder의 하위 folder)에서 공유되는 경우, 저장소는 해당 이미지를 사용하는 모든 project를 포함하는 가장 깊은 folder에 귀속됩니다:

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

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

공통 상위 folder가 없는 서로 다른 root folder의 project에서 이미지가 공유되는 경우, 저장소는 workspace 수준에 귀속됩니다:

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

image.jpg 저장소는 Workspace에 귀속됩니다(두 project를 모두 포함하는 단일 folder가 없음)
```

### 사용량 보기

workspace의 credit usage 페이지에서 folder별 세부 내역을 포함한 사용량을 볼 수 있으며, 귀속 필터를 다음으로 전환할 수 있습니다 **Folders**. 자세히 [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 Usage 일시 중지 및 재개

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를 한 번에 재개할 수도 있습니다.

재개는 folder 일시 중지 기능으로 일시 중지된 key에만 영향을 줍니다. 다른 이유로 비활성화된 key에는 영향을 주지 않습니다.

### Folder API Keys

Billing Folders가 활성화되면 각 folder는 자동으로 자체 API key를 받습니다. 이 key는 청구 대상 사용량이 어느 folder에 속하는지 내부적으로 추적하는 데 사용됩니다.

* **키 보기**: 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 사용량 데이터를 조회할 수 있습니다 [billing usage report REST API](/developer/rest-api/billing-folders-usage-report.md).