> 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/agents/roboflow-agent.md) 채팅에서 사용량 관련 질문을 할 수 있습니다(예: "이번 주기 동안 몇 크레딧을 사용했나요?" 또는 "API 키별로 지난 30일간의 사용량을 보여주세요"). 그러면 관련 필터가 적용된 상태로 크레딧 사용 대시보드가 탭으로 열립니다.

{% hint style="info" %}
워크스페이스 설정 > "크레딧 사용"에서 크레딧 사용 페이지에 접근할 수 있습니다.
{% 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)
3. 현재 플랜 주기

{% hint style="info" %}
연간 플랜을 포함한 일부 워크스페이스에는 "플렉스 주기"가 있습니다. 이는 플렉스 사용량이 플랜이 청구되는 시점과는 별도의 간격으로 청구된다는 뜻입니다. 자세한 내용은 Credits 페이지의 [플렉스 사용 섹션에서 확인하세요.](/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="/files/d5692f41f0830af01a404850f6f41891e16b5374" alt=""><figcaption></figcaption></figure>

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

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

기본적으로 차트는 크레딧 사용량을 누적해서 표시하도록 설정되어 있습니다. 즉, 차트의 "막대"는 주기 내에서 사용한 크레딧을 반영합니다. 예를 들어 가장 오른쪽 "막대"가 15 크레딧에 있다면, 이번 주기에 15 크레딧을 사용한 것입니다.\
\
이 옵션이 꺼져 있으면, 하루에 사용한 크레딧 수를 표시하며, 아래 이미지처럼 크레딧을 가장 많이 사용한 날의 급증을 더 쉽게 파악할 수 있습니다:<br>

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

#### 2. 날짜 범위

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

#### 3. 필터

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

<details>

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

귀속 필터에서는 Roboflow 내의 API 키 또는 폴더에 귀속된 사용량을 필터링하도록 선택할 수 있습니다.\
\
이를 통해 특정 폴더(특정 팀, 그룹 또는 부서에 할당할 수 있음) 또는 특정 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. 표시 모드

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

### 사용량 예측

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

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

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

#### 예측 사용자 지정

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

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

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

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

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

### 현재 주기 분석

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

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

페이지 하단에서 다음 항목에 대해 워크스페이스 한도에 얼마나 근접했는지 확인할 수 있습니다:

* 팀원
* 프로젝트

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

페이지 하단에서 "훈련 비용 추정기"를 펼치면 특정 모델 유형, 에포크 수, 데이터셋 형태에 대해 학습 작업이 얼마나 걸리고 몇 크레딧이 드는지 예측할 수 있습니다.

### 크레딧 소비 감사 로그

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

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

이 화면에서 보려는 날짜 범위를 선택하고 검색을 클릭하세요.

이 보기는 어떤 작업이 크레딧을 사용하고 있는지 더 잘 파악할 수 있도록 크레딧 사용과 관련된 정확한 기능 및 타임스탬프를 보여줍니다.

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

참조 [청구 폴더 사용량 보고서](/get-started/ko/platform/billing-and-plans/billing-folders.md#http-api) 원시 REST 엔드포인트는.

## CLI

```bash
roboflow 워크스페이스 플랜
roboflow 워크스페이스 사용량
```