---
title: Usage
description: Sume 사용량 원장 항목과 잔액을 확인하는 방법을 살펴보세요.
---

[Usage 대시보드](https://www.sume.com/dashboard/usage)를 열면 과금 대상
Developer API 활동을 사람이 보기 좋게 요약해서 볼 수 있습니다. 프로그래밍
방식으로는 다음에서 사용량을 읽습니다.

```text
GET /v1/balance
GET /v1/usage
```

정확한 스키마는 라이브 [OpenAPI](https://api.sume.com/reference/json)에
있습니다.

## 잔액

```bash
curl https://api.sume.com/v1/balance \
  -H "Authorization: Bearer $SUME_API_KEY"
```

잔액은 USD 기준입니다. 호환용 필드는 반올림한 센트 값을 크레딧으로 노출할 수
있습니다.

## 사용량 원장

```bash
curl https://api.sume.com/v1/usage \
  -H "Authorization: Bearer $SUME_API_KEY"
```

사용량 항목에는 워크스페이스와 환경에 따라 예약, 확정, 환불, 충전, 그랜트가
포함될 수 있습니다.

| 상태 | 의미 |
|---|---|
| `reserved` | 프로바이더 실행 전에 추정 사용량을 예약했습니다. |
| `captured` | 성공적으로 완료된 뒤 과금 대상 사용량을 확정했습니다. |
| `refunded` | 확정 전에 실패하거나 취소되어 예약한 사용량을 되돌렸습니다. |

Job ID와 request id로 사용량 행과 생성 워크플로를 연결하세요.

기능별 과금 요율은
[API 가격 페이지](https://www.sume.com/pricing/api)에 있습니다. 여기에 중복해서
싣지 않습니다. 그 페이지는 API가 실제로 과금하는 것과 같은 가격 상수에서
생성됩니다.

플랜 변경과 충전은
[Billing & subscription](https://www.sume.com/dashboard/subscription)에서
처리하세요.