> 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/credits/view-credit-usage.md).

# 크레딧 사용량 보기

사용량 차트, 예측, 주기 내역, 소비 감사 로그로 워크스페이스 크레딧 사용량을 살펴보세요.

크레딧 사용 방식, 사용 시점, 그리고 과거 사용 패턴은 크레딧 사용 페이지에서 확인할 수 있습니다. 또한 [Roboflow Agent](/get-started/ko/agents/roboflow-agent.md) 에 사용량 질문을 채팅으로 할 수 있습니다(예: "이번 사이클에 크레딧을 얼마나 사용했나요?" 또는 "API 키별로 지난 30일간의 사용량을 보여주세요"). 그러면 관련 필터가 적용된 상태로 크레딧 사용 대시보드가 탭으로 열립니다.

{% hint style="info" %}
워크스페이스 설정 > "크레딧 사용"에서 크레딧 사용 페이지에 접근할 수 있습니다.
{% endhint %}

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-68ae7fc4d27e2db473aa61e36cb1aa62c0925e65%2Fimage%20(446).png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

상단에서 다음 항목을 볼 수 있습니다:

1. 설명 페이지로 연결되는 링크 [Roboflow에서 크레딧이 작동하는 방식](/get-started/ko/platform/billing-and-plans/credits.md)
2. 다음으로 이동하는 버튼: [크레딧 소비 감사 로그](#credit-consumption-audit-log)
3. 현재 플랜 사이클

{% hint style="info" %}
연간 플랜을 포함한 일부 워크스페이스에는 "Flex 사이클"이 있으며, 이는 Flex 사용량이 플랜 청구와는 별도의 간격으로 청구된다는 뜻입니다. 자세한 내용은 [크레딧 페이지의 Flex 사용량 섹션](/get-started/ko/platform/billing-and-plans/credits.md#flex-usage).
{% endhint %}

워크스페이스의 크레딧 사용량을 이해하는 데 사용할 수 있는 주요 도구는 네 가지입니다:

* [사용량 차트](#usage-chart)
* [사용량 예측](#usage-projection)
* [현재 사이클 세부 내역](#current-cycle-breakdown)
* [크레딧 소비 감사 로그](#credit-consumption-audit-log)

### 사용량 차트

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-f7001a03a9914b0255e735d6c4c9ef1d1367541a%2Fimage%20(450).png?alt=media" alt=""><figcaption></figcaption></figure>

워크스페이스의 크레딧 사용량을 더 잘 이해하는 데 사용할 수 있는 사용량 차트 내 기능이 여러 개 있습니다. (숫자는 위 이미지의 레이블을 반영합니다)

#### 1. 누적 모드 토글

기본적으로 차트는 크레딧 사용량을 누적 방식으로 표시하도록 설정되어 있습니다. 즉, 차트의 "막대"는 해당 사이클 내에서 사용한 크레딧을 나타냅니다. 예를 들어 오른쪽 끝의 "막대"가 15크레딧이라면, 이번 사이클에 15크레딧을 사용했다는 뜻입니다.\
\
이 기능이 꺼져 있으면 일별 크레딧 사용량을 표시하며, 아래 이미지처럼 크레딧을 가장 많이 사용한 날의 급증 현상을 더 쉽게 확인할 수 있습니다:<br>

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-29c785252356811d29c621d37b056c4ae9901bf8%2Fimage%20(448).png?alt=media" alt="" width="188"><figcaption></figcaption></figure>

#### 2. 날짜 범위

플랜 사이클(워크스페이스 플랜 청구/포함 한도 사이클) 또는 날짜 기간으로 선택할 수 있습니다.

#### 3. 필터

"귀속" 필터 및/또는 "사용 유형" 필터를 선택할 수 있습니다.

<details>

<summary><strong>귀속 필터:</strong> 특정 폴더 또는 API 키의 워크스페이스 사용량 추적</summary>

귀속 필터에서는 API 키에 귀속된 사용량 또는 Roboflow 내 폴더에 귀속된 사용량 중 하나를 선택할 수 있습니다.\
\
이를 통해 특정 팀, 그룹 또는 부서에 할당될 수 있는 특정 폴더의 워크스페이스 사용량이나 특정 사용 사례, 장치 또는 배포에 할당될 수 있는 특정 API 키의 워크스페이스 사용량을 추적할 수 있습니다.\
\
**API 키 필터링**<br>

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-82e8264fc5ab610b84b1cc0ca783e4c805938b91%2Fimage%20(451).png?alt=media" alt="" width="258"><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-b44af8827df1be86ba085c080bb8af5065d71111%2Fimage%20(454).png?alt=media" alt="" width="358"><figcaption></figcaption></figure>

{% hint style="info" %}
청구 폴더는 프리미엄 기능입니다. 자세히 알아보기 [여기](/get-started/ko/platform/billing-and-plans/billing-folders.md)
{% endhint %}

</details>

<details>

<summary><strong>사용 유형 필터:</strong> 다양한 사용 범주 또는 특정 기능별로 필터링</summary>

사용량을 서로 다른 범주나 크레딧 사용이 발생한 특정 기능으로 필터링할 수 있습니다. 더 세부적인 옵션을 보려면 드롭다운을 클릭하세요.\
\
![](https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-78ec5570350a56163d0abba324966b5044529674%2Fimage%20\(452\).png?alt=media)

{% hint style="info" %}
이 필터에는 크레딧 사용이 발생한 범주와 기능만 표시됩니다.
{% endhint %}

</details>

#### 4. 표시 모드

워크스페이스의 크레딧당 가격(워크스페이스, 플랜, 맞춤 계약에 따라 다를 수 있음)에 따라 크레딧(기본값) 또는 달러 중 하나로 표시할 수 있습니다.

### 사용량 예측

"예측" 탭에서는 최근 활동을 기반으로 향후 크레딧 사용량을 예측할 수 있습니다.

예측 탭을 열면 다음을 볼 수 있습니다:

* **예상 크레딧 사용량** 소비할 것으로 예상되는 크레딧 총량
* **추가 예상 크레딧** 사용량이 포함된 크레딧을 초과할 가능성이 있으면 경고합니다

#### 예측 사용자 지정

"가정 사용자 지정"을 클릭하여 시나리오 빌더를 열면 다음을 할 수 있습니다:

* **예측 길이 설정** 현재 사이클 종료, 다음 사이클 종료, 3개월, 1년 또는 사용자 지정 날짜로
* **기준 기간 변경** 예측에 어떤 과거 사용 데이터가 반영될지 제어
* **기능별 사용률 조정** "만약" 시나리오를 모델링하기 위해(예: 추론 볼륨 증가 또는 새 기능 추가)

현재 비율을 기준으로 시나리오를 만들거나, 개별 기능 비율을 사용자 지정하거나, 처음부터 시작할 수 있습니다.

#### 예측 저장, 공유, 게시

예측을 나중에 참고할 수 있도록 저장하거나, 링크를 통해 팀원과 공유하거나, 공개적으로 게시할 수 있습니다. 저장된 예측은 예측 탭에서 접근할 수 있으며 모든 사용자 지정 가정을 유지합니다.

### 현재 사이클 세부 내역

현재 사이클 세부 내역에서는 현재 청구 사이클의 크레딧 지출 개요를 볼 수 있습니다.

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-e25fb0a179c44021fbc1955dae6dfd3189905b09%2Fimage%20(388).png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

현재 청구 사이클에서 사용한 크레딧의 세부 내역을 볼 수 있으며, 기능별로 요약되고 Dataset, Train, Deploy 전반에 걸쳐 구분되어 표시됩니다.

<figure><img src="https://83860450-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1YMZNIiZMBdlCHUDeZMP%2Fuploads%2Fgit-blob-18224adabfbd7bbe33a7d13af7ff39a4b8cf1988%2Fimage%20(389).png?alt=media" alt="" width="563"><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-1a2329baebe5168085f592ff1ce790e47b48d42e%2Fimage%20(390).png?alt=media" alt="" width="563"><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-62cc16b49e586a8d64de0eabd86d19a35ee174a2%2Fimage%20(445).png?alt=media" alt="" width="375"><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-d323bb1d0720ded4426b6a7aaa1318532c57d6f1%2Fimage%20(444).png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

## Cloud Streaming 사용량

다음 항목의 경우 [Cloud Streaming](https://docs.roboflow.com/deployment/roboflow-cloud/cloud-streaming), 날짜 범위와 사용 유형 필터를 사용해 처리 소비량과, 가능한 경우 API 키 귀속을 검토하세요. 기능은 사용량이 기록된 후에만 필터에 표시됩니다.

스트림 세부 정보 페이지의 시간당 요율은 누적되거나 과거 지출이 아니라 현재 할당 요율입니다. 미리보기 및 테스트 처리도 인터페이스에 가격이 표시되지 않더라도 사용량에 포함될 수 있습니다. 다음을 참조하세요 [Cloud Streaming 가격 및 한도](https://docs.roboflow.com/deployment/roboflow-cloud/cloud-streaming/pricing-and-limits) 를 확인한 후 지속적인 비용을 추정하세요.

## Python SDK

`Workspace.get_plan()` 는 워크스페이스의 청구 플랜, 포함된 크레딧, 기능 한도를 반환합니다. `Workspace.get_usage()` 는 해당 사용 보고서(추론 호출, 학습 크레딧, 이미지 수)를 반환합니다.

이는 내부 도구에 청구 대시보드를 내장하거나, 유료 크레딧을 사용하는 자동화를 안전하게 제한하는 데 유용합니다.

### 플랜 가져오기

```python
import roboflow

rf = roboflow.Roboflow(api_key="YOUR_API_KEY")
workspace = rf.workspace()

plan = workspace.get_plan()
print(plan["name"])             # 예: "growth"
print(plan.get("limits", {}))   # 포함된 이미지 / 추론 / 학습 할당량
```

### 사용량 가져오기

```python
usage = workspace.get_usage()
print(usage)
```

응답은 워크스페이스의 [웹 앱의 청구 사용 보고서를 구동하는 동일한 JSON입니다](https://app.roboflow.com/) - 월 누계 이미지 업로드, 소비된 학습 크레딧, 호스티드/전용 추론 횟수.

## HTTP API

동일한 데이터는 다음에서 제공됩니다:

* `GET /usage/plan` - 플랜 정보
* `POST /:workspace/billing-usage-report` - 사용량 세부 내역

다음을 참조하세요 [청구 폴더 사용량 보고서](/get-started/ko/platform/billing-and-plans/billing-folders.md#http-api) 원시 REST 엔드포인트의 경우.

## CLI

```bash
roboflow workspace plan
roboflow workspace usage
```