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

# 크레딧 사용량 보기

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

{% hint style="info" %}
Workspace 설정 > "Credit Usage"에서 Credit Usage 페이지에 접근할 수 있습니다
{% endhint %}

<figure><img src="/files/7aa1f7b7e7595b6b908260da8f2846ab6dce8196" alt="" width="563"><figcaption></figcaption></figure>

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

1. 다음을 설명하는 페이지로 연결되는 링크 [Roboflow 내에서 크레딧이 어떻게 작동하는지](/get-started/ko/platform/billing-and-plans/credits.md)
2. 다음으로 이동하는 버튼 [Credit Consumption Audit Log](#credit-consumption-audit-log)
3. 현재 플랜 주기

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

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

* [사용량 차트](#usage-chart)
* [사용량 예측](#usage-projection)
* [현재 주기 세부 내역](#current-cycle-breakdown)
* [Credit Consumption Audit Log](#credit-consumption-audit-log)

### 사용량 차트

<figure><img src="/files/d5692f41f0830af01a404850f6f41891e16b5374" alt=""><figcaption></figcaption></figure>

워크스페이스의 크레딧 사용량을 더 잘 이해하는 데 사용할 수 있는 사용량 차트 내 기능이 여러 가지 있습니다: (숫자는 위 이미지의 레이블을 나타냅니다)

#### 1. 누적 모드 전환

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

<figure><img src="/files/ccbf55911f78fbd3151993b54820c69c515402a4" alt="" width="188"><figcaption></figcaption></figure>

#### 2. 날짜 범위

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

#### 3. 필터

"Attribution" 필터 및/또는 "Usage Type" 필터를 선택할 수 있습니다

<details>

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

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

<figure><img src="/files/cb431301d06202b945623bb030429ecc72c9b808" alt="" width="258"><figcaption></figcaption></figure>

**청구 폴더**

이것은 각 폴더의 사용량 데이터가 포함된 워크스페이스의 폴더 구조를 계층형 트리 뷰로 표시합니다. 다음을 할 수 있습니다:

* 폴더를 확장 및 접기하여 하위 폴더 사용량을 자세히 확인
* 폴더를 선택하거나 선택 해제하여 사용량 차트를 필터링

사용량은 기본적으로 상위 폴더 기준으로 합산됩니다. 상위 폴더의 직접 사용량을 차트에서 제외하고 하위 폴더의 사용량만 보려면 상위 폴더를 선택 해제할 수 있습니다.

<figure><img src="/files/297c1af9fa5ac0454ef106975924593b0a25cdff" 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>

사용량을 다른 범주나 크레딧 사용량이 있는 특정 기능으로 필터링할 수 있습니다. 더 세부적인 옵션을 보려면 드롭다운을 클릭하세요.\
\
![](/files/62f94aa13b594d31ccf229695074cbd134f37eb7)

{% hint style="info" %}
크레딧 사용량이 있었던 범주와 기능만 이 필터에 표시됩니다.
{% endhint %}

</details>

#### 4. 표시 모드

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

### 사용량 예측

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

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

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

#### 예측 맞춤 설정

"Customize Assumptions"를 클릭하여 Scenario Builder를 열면 다음을 할 수 있습니다:

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

현재 비율에서 시나리오를 만들거나, 개별 기능 비율을 맞춤 설정하거나, 처음부터 시작할 수 있습니다.

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

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

### 현재 주기 세부 내역

Current Cycle Breakdown에서는 현재 청구 주기의 크레딧 지출 개요를 볼 수 있습니다.

<figure><img src="/files/3e5cda73c608b8468911e667679268bded10348c" alt="" width="563"><figcaption></figcaption></figure>

현재 청구 주기에서 사용한 크레딧의 세부 내역을 볼 수 있으며, 기능별로 요약되고 Dataset, Train, Deploy로 나뉘어 표시됩니다

<figure><img src="/files/80f0e460ac5221f97d503c7bb46c18ac523cd69d" alt="" width="563"><figcaption></figcaption></figure>

페이지 하단에서 다음 항목에 대한 Workspace Limits에 얼마나 가까운지 확인할 수 있습니다:

* 팀원
* 프로젝트

<figure><img src="/files/08b0390279aa31d52dc4f839c8b97fa00d9a660d" alt="" width="563"><figcaption></figcaption></figure>

페이지 하단에서 "Training Cost Estimator"를 펼치면 특정 모델 유형, 에폭 수, 데이터셋 형태에 대해 학습 작업이 얼마나 걸릴지, 그리고 얼마의 크레딧이 소요될지를 예측할 수 있습니다.

### Credit Consumption Audit Log

크레딧의 상세 사용 내역을 보려면 상단의 "Audit Log"를 클릭하세요.

<figure><img src="/files/0051b334861001782e6e585626dd103c079406d5" alt="" width="375"><figcaption></figcaption></figure>

이 화면에서 보고 싶은 날짜 범위를 선택한 다음 Search를 클릭하세요.

이 보기는 크레딧 사용량과 연관된 정확한 기능 및 타임스탬프를 보여 주어 어떤 작업이 크레딧을 사용하는지 더 잘 파악하는 데 도움이 됩니다.

<figure><img src="/files/cf512e7bbf02985521a79ce281700979fcb1013d" alt="" width="563"><figcaption></figcaption></figure>

## 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` - 사용량 세부 내역

다음 문서를 참조하세요 [Billing Folders Usage Report](/get-started/ko/platform/billing-and-plans/billing-folders.md#http-api) 원시 REST 엔드포인트에 대해.

## CLI

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