---
title: 결제와 크레딧
description: Sume 크레딧의 동작 방식, 크레딧이 생기는 곳, 크레딧을 더 구매하는 곳을 살펴보세요.
---

Sume는 모든 사용량을 크레딧으로 셉니다. 생성, Sume Agent, Formats, Developer
API는 모두 워크스페이스의 크레딧 잔액 하나에서 크레딧을 사용합니다.

[Billing & subscription](https://www.sume.com/dashboard/subscription)을 열면
플랜과 사용 가능한 크레딧을 확인할 수 있습니다. 팀 워크스페이스에서는 이 링크가
팀의 결제 페이지를 엽니다.

(제품 내비게이션 라벨은 **Billing & subscription**입니다. 예전 문서에서는 이
표면을 "Credits"라고 불렀습니다.)

구독 플랜은 [Pricing](https://www.sume.com/pricing)에, 기능마다 사용하는
크레딧은 [API 요금표](https://www.sume.com/pricing/api)에 있습니다.

## 크레딧이 생기는 곳

| 크레딧 | 생기는 곳 |
|---|---|
| 플랜 크레딧 | 유료 플랜은 결제 주기가 시작될 때마다 크레딧을 추가합니다. 이 크레딧은 그 주기가 끝나면 만료되며 이월되지 않습니다. |
| 무료 크레딧 | Free 플랜은 워크스페이스에 크레딧을 딱 한 번 지급합니다. |
| 구매한 크레딧 | 팀 워크스페이스는 결제 페이지에서 언제든 크레딧을 더 구매할 수 있습니다. 플랜 크레딧보다 오래 유지되지만, 역시 만료됩니다. |

Sume는 플랜 크레딧을 먼저 사용하고, 그다음 구매한 크레딧을 사용합니다. 같은
종류 안에서는 가장 먼저 만료되는 크레딧부터 사용합니다. 다음 만료 정보는
`GET /v1/balance`의 `expiration`에 나옵니다.

## 요청이 크레딧을 사용하는 방식

유료 요청은 Sume가 접수할 때 크레딧을 예약하고, 요청이 완료되면 Sume가 그
크레딧을 확정합니다. 실패한 생성이나 시작 전에 취소한 생성은 크레딧을 잔액으로
되돌려줍니다. 각 단계는 사용량 원장에 나타납니다. [Usage](/dashboard/usage)에서
살펴보세요.

제품의 Generate 버튼은 요청을 시작하기 전에 그 요청이 사용할 크레딧을 보여
줍니다. MCP에서는 `dry_run=true`로 호출하면 아무것도 제출하지 않고 추정치를
`usage.credits`로 돌려받습니다.

크레딧 잔액으로 요청을 감당할 수 없으면 API는
"Not enough credits for this request." 메시지와 함께
`402 insufficient_credits`를 반환합니다. `details.required_credits`는 요청에
필요한 크레딧이고, `details.available_credits`는 워크스페이스가 가진
크레딧입니다. 플랜을 업그레이드하거나 팀 크레딧을 구매한 뒤 다시 시도하세요.

## 현재 공개된 읽기 API

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

이 엔드포인트들은 읽기 전용이며 인증된 API 키의 워크스페이스로 범위가
제한됩니다. 필드 설명은 [Usage](/dashboard/usage)에, 정확한 스키마는 라이브
[OpenAPI](https://api.sume.com/reference/json)에 있습니다.

## 크레딧 구매

워크스페이스에 결제가 설정돼 있으면 팀 결제 페이지에서 Stripe 결제를 시작해
크레딧을 더 구매할 수 있습니다. 결제가 완료되면 사용량 원장에 구매 내역이,
잔액에 새 크레딧이 나타납니다.

크레딧은 팀 워크스페이스만 구매할 수 있습니다. 개인 워크스페이스는 플랜을
업그레이드하거나, 팀을 만들거나 팀에 합류해서 크레딧을 더 얻습니다.

API 클라이언트에게 크레딧 구매는 대시보드 작업입니다. 공개 Developer API는 현재
잔액과 사용량 읽기만 제공하며, 크레딧을 구매하는 공개 엔드포인트는 없습니다.