> 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 영업팀에](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 %}

#### API 또는 Deployment 사용량

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

workspace 수준 API key로 보낸 request는, 사용된 model이 folder에 있는 project에 속하더라도 workspace에 귀속됩니다. direct API 또는 batch usage를 folder에 귀속시키려면 해당 folder의 API key로 request하세요.

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

이미지 저장소는 이미지를 참조하는 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 저장소는 이를 참조하는 모든 project를 포함하는 가장 깊은 folder인 Folder A에 귀속됩니다
```

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

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

image.jpg 저장소는 Workspace에 귀속됩니다(하나의 folder에 두 project가 모두 포함되지 않음)
```

### 사용량 보기

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 사용량 일시 중지 및 재개

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 request는 다음과 함께 거부됩니다 `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를 볼 수 있습니다.
* **자동 생성**: API key는 folder가 생성될 때 또는 workspace에서 Billing Folders가 처음 활성화될 때 자동으로 생성됩니다. 수동으로 생성할 필요가 없습니다.

### 일반적인 시나리오

| 시나리오                       | 무슨 일이 발생하나요                                                                                              |
| -------------------------- | -------------------------------------------------------------------------------------------------------- |
| **project를 다른 folder로 이동** | 해당 project의 향후 사용량은 새 folder에 귀속됩니다. 과거 사용량은 원래 folder에 귀속된 상태로 유지됩니다.                                   |
| **folder 삭제**              | folder가 workspace에서 제거됩니다. 하위 project와 sub-folder는 상위 folder로 재할당됩니다. 과거 사용량 데이터는 billing report에 보존됩니다. |
| **새 folder 만들기**           | 새 folder는 billing 귀속을 위한 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).


---

# 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-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.