計費與消費
一個組織共享單個錢包，為其成員和已納管代理程式的按量計費提供資金。 admin 為它充值，所有人的用量都從中扣減，admin 還可以設定消費上限 來約束它被消耗的速度。這一切都在組織控制台 → 設定 → Billing 中管理。
積分是計量用量的單位（1 美元 = 100 積分）；開發者 API 上哪些操作免費、 哪些計量，見API 總覽。
組織錢包
GET /org/{orgId}/wallet 返回該組織的餘額和最近的流水。任何組織成員
都能查看錢包；只有 admin/owner 能為它充值。
- 餘額 —— 共享積分（在適用場景下還含現金部分），為該組織的代理程式 和運行提供資金。
- 流水 —— 最近的交易記錄：充值（
deposit）、spend、refund以及發放的credit。
充值走付費購買鏈路（在錢包卡片上充值）；隨後已納管代理程式和成員從這份 共享餘額中扣減。
用量儀表板
GET /org/{orgId}/usage?window=day|month 返回按類別（按 reason）劃分的
消費明細，以及當前 UTC 日或月的上限狀態（預設：month）。
用量明細屬於組織管理視圖，因此要求 admin 或 owner。用它來看清積分
花在了哪裡，以及組織離上限還有多遠。
消費上限
admin 可以限制組織每日和每月能消耗多少積分。
上限通過 PATCH /org/{orgId}/spend-caps 設定，並由 Hub 強制執行 ——
這是真實的限制，不只是儀表板上的指示：
bash
PATCH /api/hub/org/{orgId}/spend-caps
{ "daily_cap_credits": 5000, "monthly_cap_credits": 100000 }
- 只發送你要修改的欄位 —— 省略某個鍵表示該上限保持不變； 發送空值會清除該上限（即無限制）。
- 該變更是冪等的，並會在 Hub 上記入審計日誌。
- 計費儀表板會展示日/月用量與各自上限的對比（
spent / cap）以及進度條， 這樣成員可以看到還剩多少餘量。
設定上限需要 admin/owner；查看用量與上限的對比屬於同一個管理儀表板的一部分。
角色。 組織裡的任何人都能查看錢包餘額。為錢包充值、查看用量明細 和設定消費上限都是 admin/owner 的操作 —— 無論 UI 顯示成什麼樣， Hub 都會強制這一點。