计费与消费
一个组织共享单个钱包，为其成员和已纳管智能体的按量计费提供资金。 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 都会强制这一点。