> 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/get-started/ko/platform/billing-and-plans/billing-folders.md).

# 청구 폴더

청구 폴더를 사용하면 워크스페이스 관리자가 폴더 수준에서 과금 사용량을 추적하고 관리할 수 있습니다.

## 개요

{% 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 Cloud API, Batch Processing 등을 포함하되 이에 국한되지 않음) 프로젝트의 폴더가 아니라 요청에 사용된 API 키를 기준으로 사용량이 귀속됩니다.

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

#### 이미지 저장 사용량 귀속

이미지 저장 사용량은 해당 이미지를 참조하는 프로젝트가 속한 폴더에 귀속됩니다.

이미지가 같은 폴더 내의 여러 프로젝트에서 공유되는 경우(또는 같은 상위 폴더의 하위 폴더에서 공유되는 경우), 저장 사용량은 해당 이미지를 사용하는 모든 프로젝트를 포함하는 가장 깊은 폴더에 귀속됩니다.

```
워크스페이스
├── 폴더 A
│   ├── 프로젝트 1  ← image.jpg
│   └── 프로젝트 2  ← image.jpg (공유됨)
└── 폴더 B
    └── 프로젝트 3

image.jpg의 저장 사용량은 폴더 A에 귀속됩니다(이미지를 참조하는 모든 프로젝트를 포함하는 가장 깊은 폴더).
```

이미지가 공통 상위 폴더가 없는 서로 다른 루트 폴더의 프로젝트에서 공유되는 경우, 저장 사용량은 워크스페이스 수준에 귀속됩니다.

```
워크스페이스
├── 폴더 A
│   └── 프로젝트 1  ← image.jpg
└── 폴더 B
    └── 프로젝트 2  ← image.jpg (공유됨)

image.jpg의 저장 사용량은 워크스페이스에 귀속됩니다(두 프로젝트를 모두 포함하는 폴더가 없음).
```

### 폴더 작업 메뉴

폴더 설정은 폴더의 작업 메뉴(점 3개 아이콘)에 있습니다. 폴더 목록이나 폴더의 프로젝트 페이지 상단에서 폴더 이름 옆에 있는 메뉴를 열 수 있습니다. 이 메뉴에는 "폴더 사용량", "폴더 API 키", "권한 설정"이 있습니다.

### 사용량 확인

워크스페이스의 크레딧 사용량 페이지에서 사용량을 확인하고 귀속 필터를 **폴더**로 전환하면 폴더별 사용량을 확인할 수 있습니다. [청구 폴더별로 사용량을 필터링하는 방법](https://docs.roboflow.com/get-started/ko/platform/billing-and-plans/view-credit-usage.md#usage-chart) 또는 [일반적인 사용량 확인 방법을 알아보세요.](https://docs.roboflow.com/get-started/ko/platform/billing-and-plans/view-credit-usage.md)

특정 폴더의 사용량으로 바로 이동하려면 해당 폴더의 작업 메뉴에서 "폴더 사용량"을 선택하세요.

### 폴더 사용량 일시 중지 및 재개

워크스페이스 관리자는 폴더 내의 모든 청구 대상 사용량을 일시적으로 중지할 수 있습니다. 이는 비용을 관리하거나 의도치 않은 사용을 방지하는 데 유용합니다.

#### 폴더 일시 중지

폴더를 일시 중지하려면 폴더의 작업 메뉴에서 "폴더 API 키"를 선택하고 "폴더 사용량 일시 중지"를 켠 다음 표시되는 메시지에서 확인하세요.

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-8d164ee175fc34c92d319779744f353172dded06%2FScreenshot%202026-04-02%20at%2010.13.20%E2%80%AFAM.png?alt=media" alt=""><figcaption></figcaption></figure>

<div><figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-d1ea7d01faf61c33dc9585d01a76d2764ce36c24%2FScreenshot%202026-04-02%20at%2010.15.56%E2%80%AFAM.png?alt=media" alt=""><figcaption></figcaption></figure> <figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-0596c5b481fcc58349fc0b677278c4bed93304b6%2FScreenshot%202026-04-02%20at%2010.17.14%E2%80%AFAM.png?alt=media" alt=""><figcaption></figcaption></figure></div>

폴더가 일시 중지되면 다음과 같이 됩니다.

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

"모든 하위 폴더의 사용량 일시 중지"를 켜면 폴더와 그 아래의 모든 하위 폴더를 한 번에 일시 중지할 수도 있습니다. 이렇게 하면 선택한 폴더와 그 아래에 중첩된 모든 폴더의 API 키가 비활성화됩니다.

#### 폴더 재개

일시 중지된 폴더를 다시 사용하려면 "폴더 API 키" 모달을 다시 열고 일시 중지 컨트롤을 끈 다음 확인합니다. 이렇게 하면 폴더의 API 키가 다시 활성화되고 정상적으로 작동합니다. 마찬가지로 폴더와 모든 하위 항목을 한 번에 다시 사용할 수 있습니다.

다시 사용하도록 설정해도 폴더 일시 중지 기능으로 일시 중지된 키에만 영향을 줍니다. 다른 이유로 비활성화된 키에는 영향을 주지 않습니다.

### 폴더 API 키

결제 폴더가 활성화되면 각 폴더에 자체 API 키가 자동으로 부여됩니다. 이 키는 청구 대상 사용량이 어느 폴더에 속하는지 내부적으로 추적하는 데 사용됩니다.

* **키 보기**: 폴더의 작업 메뉴에서 "폴더 API 키"를 선택하면 해당 폴더에 연결된 API 키를 볼 수 있습니다.
* **자동 생성**: 폴더를 만들거나 작업 공간에서 결제 폴더를 처음 활성화하면 API 키가 자동으로 생성됩니다. 수동으로 만들 필요가 없습니다.

### 일반적인 시나리오

| 시나리오                | 결과                                                                                           |
| ------------------- | -------------------------------------------------------------------------------------------- |
| **프로젝트를 다른 폴더로 이동** | 해당 프로젝트의 이후 사용량은 새 폴더에 귀속됩니다. 과거 사용량은 원래 폴더에 계속 귀속됩니다.                                       |
| **폴더 삭제**           | 작업 공간에서 폴더가 삭제됩니다. 하위 프로젝트, 워크플로, 기기, 카메라 및 하위 폴더는 상위 폴더로 재할당됩니다. 과거 사용량 데이터는 결제 보고서에 보존됩니다. |
| **새 폴더 만들기**        | 새 폴더에는 결제 귀속을 위한 API 키가 자동으로 부여됩니다. 추가 설정은 필요하지 않습니다.                                        |
| **결제 폴더 비활성화**      | 폴더 수준의 귀속이 중단됩니다. 새 사용량은 작업 공간 수준에서만 추적됩니다. 폴더 결제 기간의 과거 사용량 데이터는 보존됩니다.                     |

### 사용량 보고서 API

다음을 사용해 결제 사용량 데이터를 프로그래밍 방식으로 조회할 수 있습니다. [결제 사용량 보고서 REST API](#http-api).

## HTTP API

### 사용량 보고서 가져오기

이 보고서를 사용하면 각 팀 또는 클라이언트의 사용량을 추적할 수 있습니다. 각 행에는 API 키 접두사, 결제 기능 및 멤버 하나가 포함되며, 해당 키를 소유한 폴더에 귀속됩니다. 멤버는 사용량을 발생시킨 로그인 사용자 또는 OAuth 토큰이 대신하는 사용자입니다. 멤버가 없는 행에서는 user\_id가 null입니다 `user_id`. 폴더에 속하지 않는 키의 사용량은 작업 공간에 귀속됩니다. 본문을 보내지 않으면 최근 7일의 데이터를 가져옵니다.

{% openapi src="/files/282d96cefcd8aa2b6e89ab980a67c843d7ddf20c" path="/{workspace}/billing-usage-report" method="post" %}
[billing-folders.yaml](https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-b6ea93a947cfec3aca2470faeef3a511ad226d6a%2Fbilling-folders.yaml?alt=media)
{% endopenapi %}
