결제와 크레딧

이 문서는 영문 원고를 AI로 번역한 내용이라 표현이 어색할 수 있습니다.

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

Billing & subscription을 열면 플랜과 사용 가능한 크레딧을 확인할 수 있습니다. 팀 워크스페이스에서는 이 링크가 팀의 결제 페이지를 엽니다.

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

구독 플랜은 Pricing에, 기능마다 사용하는 크레딧은 API 요금표에 있습니다.

크레딧이 생기는 곳

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

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

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

유료 요청은 Sume가 접수할 때 크레딧을 예약하고, 요청이 완료되면 Sume가 그 크레딧을 확정합니다. 실패한 생성이나 시작 전에 취소한 생성은 크레딧을 잔액으로 되돌려줍니다. 각 단계는 사용량 원장에 나타납니다. 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

이 엔드포인트들은 읽기 전용이며 인증된 API 키의 워크스페이스로 범위가 제한됩니다. 필드 설명은 Usage에, 정확한 스키마는 라이브 OpenAPI에 있습니다.

크레딧 구매

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

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

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