GET/api/quota/balance

用量與餘額

點數沿帳戶 → 組織 → 工作區 → 專案（project）階層下放。只有專案（葉節點）的餘額是即時消耗的——Gateway 每一筆請求都會即時扣減。組織與工作區的餘額是轉撥池，只在撥款／退回時變動。

查詢餘額#

要輪詢哪一個？

做自動切換模型或預算告警，請輪詢 /api/quota/balance（三個 id 都帶）——它是唯一每筆請求都會更新的值。billing/summary 的彙總在數分鐘內落帳，適合報表，不適合即時決策。

自動化要用的端點。proj_balance 讀的是 Gateway 每筆請求即時扣減的儲存，因此即時反映用量；proj_inflight 是進行中請求的預留額。

curl -sS "https://admin.atptoken.ai/api/quota/balance?org_id=<org>&workspace_id=<ws>&project_id=<proj>" \
  -H "Authorization: Bearer $TOKEN"

同樣的三層餘額，以逐層區塊呈現。只回「剩餘餘額」——點數模型不儲存「期初配額」，因此沒有使用率欄位。

呼叫者 account 層的 plan 與點數餘額。

每月用量與計費彙總：指定 period（YYYY-MM，預設當前 UTC 月份）內各模型的 token 總量、請求數、計量與點數。範圍級視角——涵蓋該 org／工作區／專案下所有金鑰。

每月各 API 金鑰用量。只回呼叫者本人建立的金鑰——這是個人視角，不是組織全量報表（全量請用 billing/summary）。

單月每日用量趨勢（UTC 分桶），支援 interval 與 group_by。與 usage-by-key 相同為個人視角。

歷史每月關帳快照（worker 於月底寫入），並為未關帳的當月附加一筆 is_current: true 合成項。months 1–24（預設 6），或以 period 查單月。

原始 token 使用紀錄（ledger），支援 since／until／cursor 分頁。

這頁有幫助嗎？