> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# 사용량과 크레딧

계량 제한, 선불 크레딧, 결제 표면.

## 사용량 상태 읽기

GET /api/mobile/usage는 AI 예산을 마이크로단위 십진 문자열로 반환합니다 — budgetMicrounits, committedMicrounits, heldMicrounits, keyMode — 와 함께 선불 크레딧 잔액, label·used·limit·cap·planLimit·description이 있는 미터별 행, 현재 기간 경계를 반환합니다. 표시는 미터를 80%에서 경고로, 100%에서 위험으로 표시합니다.

값은 JSON 숫자가 아니라 십진 문자열입니다 — 큰 예산이 정확하게 유지되도록 비교하거나 형식을 지정하기 전에 파싱하세요.


## 선불 크레딧 원장

GET /api/mobile/credits는 워크스페이스의 선불 잔액과 최근 50개의 원장 행을 반환합니다. 잔액은 설정 → 결제와 홈 사용량 카드에 표시되고, 원장 참조 id는 클라이언트 페이로드에서 제외됩니다.


## 홈과 결제 표면

홈 화면은 GET /api/workspace/metrics를 재사용합니다 — 웹 대시보드가 렌더링하는 것과 같은 통계 그리드로, 월간 AI 지출, 작업 및 스레드 수, 멤버, 대기 중인 초대, 플랜 상태, 읽지 않은 알림을 보여줍니다. 사용량 카드는 AI 행과 한도가 있는 미터를 표시하고, 빠른 작업 타일은 chat, assistant, content, commerce, notifications, feedback, settings로 연결됩니다.

설정 → 결제는 플랜, 만료일, 크레딧 잔액, 사용량 미터를 보여주고, 스토어와 웹 결제의 차이를 설명하며, 페이월로 연결됩니다. 서버 스케줄이 15분마다 워크스페이스를 스윕하고 AI 예산의 80%와 100%에서 owner와 admin에게 한 달에 한 번 알립니다.


## 검증 및 문제 해결

한도에 가까운 미터, 소진된 크레딧 잔액, 기본 예산의 워크스페이스를 확인하세요. 차단된 작업은 일반적인 오류가 아니라 거부한 미터를 가리켜야 합니다.

[네이티브 구매와 복원](https://supastack.dev/ko/docs/mobile/revenuecat.md)


## 다음

[콘텐츠 관리](https://supastack.dev/ko/docs/mobile/content.md)