> ## 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 返回工作區的預付餘額與最近五十條臺賬記錄。餘額供“設定 → 賬單”與首頁用量卡片使用；臺賬的引用 id 不會下發給客戶端。


## 首頁與賬單介面

首頁複用 GET /api/workspace/metrics —— 與 Web 儀錶板渲染的同一組統計：月度 AI 支出、任務與執行緒數、成員、待處理邀請、計劃狀態與未讀通知。用量卡片顯示 AI 行加上有上限的計量項，快捷操作磁貼連結到聊天、助手、內容、電商、通知、反饋與設定。

“設定 → 賬單”顯示計劃、到期時間、額度餘額與用量計量，解釋商店計費與 Web 計費的區別，並連結到付費牆。一個服務端計劃任務每十五分鐘掃過所有工作區，並在 AI 預算達到 80% 與 100% 時每月通知一次所有者與管理員。


## 驗證與排障

檢查接近上限的計量項、耗盡的額度餘額，以及使用預設預算的工作區。被阻止的操作必須指向拒絕它的那個計量項，而不是泛泛的錯誤。

[原生購買與恢復](https://supastack.dev/zh-tw/docs/mobile/revenuecat.md)


## 下一篇

[內容管理](https://supastack.dev/zh-tw/docs/mobile/content.md)