> 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 플랜에서 사용할 수 있는 기능입니다. 워크스페이스에서 Billing Folders를 사용 설정하려면 [Roboflow 영업팀에](https://roboflow.com/sales) 또는 계정 담당자에게 문의하세요. 사용 가능한 플랜에 대한 자세한 내용은 [요금 페이지](https://roboflow.com/pricing).
{% endhint %}

활성화되면 모든 사용량(예: 학습, 추론, 이미지 저장, 라벨링 등)은 사용 중인 프로젝트를 포함하는 폴더에 자동으로 할당됩니다. 이를 통해 조직은 팀, 부서 또는 고객 전반에 걸쳐 세분화된 비용 가시성과 지출 통제 기능을 확보할 수 있습니다.

### 사용량 할당 방식

Billing Folders가 활성화되면 워크스페이스의 각 폴더는 고유한 API 키를 받습니다. 폴더 내 프로젝트에서 발생하는 모든 과금 대상 사용량은 해당 폴더의 API 키 기준으로 추적됩니다. 즉, 사용량 보고서와 대시보드에서 각 폴더가 얼마나 사용하고 있는지 정확히 확인할 수 있습니다.

{% hint style="info" %}
사용량 할당은 자동으로 이루어집니다. 사용량을 폴더에 수동으로 할당할 필요가 없습니다. 사용량은 프로젝트에서 상위 폴더로 전달됩니다.
{% endhint %}

#### API 또는 배포 사용량

API 키를 사용하여 Roboflow 서비스를 사용할 때(Serverless API, Batch Processing 등을 포함하되 이에 국한되지 않음), 과금 할당은 프로젝트의 폴더가 아니라 요청에 사용된 API 키를 따릅니다.

워크스페이스 수준 API 키로 보낸 요청은 사용된 모델이 폴더 안의 프로젝트에 속해 있더라도 워크스페이스에 할당됩니다. 직접 API 또는 batch 사용량을 폴더에 할당하려면 해당 폴더의 API 키로 요청하세요.

#### 이미지 저장 할당

이미지 저장은 이미지를 참조하는 프로젝트가 포함된 폴더에 할당됩니다.

이미지가 동일한 폴더 내의 여러 프로젝트 또는 동일한 상위 폴더의 하위 폴더들에 걸쳐 공유되는 경우, 저장은 해당 이미지를 사용하는 모든 프로젝트를 포함하는 가장 깊은 폴더에 할당됩니다:

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

image.jpg 저장은 Folder A에 할당됩니다(이를 참조하는 모든 프로젝트를 포함하는 가장 깊은 폴더)
```

이미지가 공통 상위 폴더가 없는 서로 다른 최상위 폴더의 프로젝트들에 걸쳐 공유되는 경우, 저장은 워크스페이스 수준에 할당됩니다:

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

image.jpg 저장은 Workspace에 할당됩니다(두 프로젝트를 모두 포함하는 단일 폴더가 없음)
```

### 사용량 보기

워크스페이스의 크레딧 사용량 페이지에서 폴더별로 세분화된 사용량을 볼 수 있으며, 할당 필터를 **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 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>

폴더가 일시 중지되면:

* 해당 폴더에 속한 모든 API 키가 비활성화됩니다
* 해당 폴더에 대해 사용량이 발생하는 모든 API 요청은 다음과 함께 거부됩니다. `423 Locked` 상태 코드
* 폴더에 대한 새로운 과금 대상 사용량은 기록되지 않습니다

Pause All Descendant Folders' Usage를 토글하여 폴더와 그 모든 하위 폴더의 사용량을 한 번에 일시 중지할 수도 있습니다. 이렇게 하면 선택한 폴더와 그 아래에 중첩된 모든 폴더의 API 키가 비활성화됩니다.

#### 폴더 재개

일시 중지된 폴더를 재개하려면 "Folder Settings" 모달로 돌아가 일시 중지 제어를 끄세요. 그러면 해당 폴더의 API 키가 다시 활성화되고 정상 동작이 복원됩니다. 마찬가지로 폴더와 그 모든 하위 폴더를 한 번에 재개할 수도 있습니다.

재개는 폴더 일시 중지 기능으로 일시 중지되었던 키에만 영향을 줍니다. 다른 이유로 비활성화된 키에는 영향을 주지 않습니다.

### 폴더 API 키

Billing Folders가 활성화되면 각 폴더는 자동으로 고유한 API 키를 받습니다. 이러한 키는 과금 대상 사용량이 어느 폴더에 속하는지 추적하기 위해 내부적으로 사용됩니다.

* **키 보기**: 폴더와 연결된 API 키를 보려면 Folder Settings 모달을 열고 API Keys 탭으로 이동하세요.
* **자동 생성**: 폴더가 생성되거나 워크스페이스에서 Billing Folders가 처음 활성화될 때 API 키가 자동으로 생성됩니다. 수동으로 생성할 필요가 없습니다.

### 일반적인 시나리오

| 시나리오                     | 발생하는 일                                                                                |
| ------------------------ | ------------------------------------------------------------------------------------- |
| **프로젝트를 다른 폴더로 이동**      | 해당 프로젝트의 향후 사용량은 새 폴더에 할당됩니다. 과거 사용량은 원래 폴더에 계속 할당됩니다.                                |
| **폴더 삭제**                | 폴더가 워크스페이스에서 제거됩니다. 하위 프로젝트와 하위 폴더는 상위 폴더로 재할당됩니다. 과거 사용량 데이터는 billing report에 보존됩니다. |
| **새 폴더 생성**              | 새 폴더에는 billing attribution을 위한 API 키가 자동으로 부여됩니다. 추가 설정은 필요하지 않습니다.                   |
| **Billing Folders 비활성화** | 폴더 수준 할당이 중지됩니다. 새로운 사용량은 워크스페이스 수준에서만 추적됩니다. 폴더 billing 기간의 과거 사용량 데이터는 보존됩니다.       |

### 사용량 보고서 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, and the optional `goal` query parameter:

```
GET https://docs.roboflow.com/roboflow/roboflow-ko/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.