用量与计费

Kisenon 会计量你实际使用的内容，并按 组织 汇总。控制台会展示你的用量， 超出每月免费额度的用量将按 定价合约 开具账单 —— 参见下文的 计费状态。

我们计量哪些内容

控制平面按项目采样三个维度，并按组织进行聚合：

计算是变动最大的那个维度：一个在空闲时挂起的 端点 会在其停止的那一刻起停止累积 CU-小时， 因此一个一天中大部分时间处于休眠的项目，其成本只是一个满负荷运行项目的一小部分。 存储和分支数量在其采样窗口内是稳定的，所以更粗的节奏就足够了。

这些采样会汇总成一个针对当前计费周期的、按组织统计的计算、 存储和分支用量的单一视图 —— 也就是计费页面所渲染的数字。

免费套餐

每个组织都从一份每月免费额度开始。也可以按组织强制执行一个 项目数量上限：当该上限启用时，一个没有在案支付方式的组织 会被限制在一个固定的项目数量内；一旦达到该数量， 再创建一个项目就会返回 free_allowance_exhausted（HTTP 403）。 有在案支付方式的组织则不受上限限制。确切的上限是一项部署设置， 而不是硬编码的数字，因此可以随时间进行调整。

随着一个周期的计量用量攀升，控制台会在主内容上方于三个阈值处 显示一个逐级升级的横幅 —— 与控制平面在其每周期通知日志中记录的 80 / 95 / 100 百分比相同：

• 80% —— 一条黄色提示："你本周期已使用超过 80% 的免费套餐。"
• 95% —— 一条琥珀色警告，提示在服务中断前添加支付方式。
• 100% —— 一个红色的耗尽状态：在添加支付方式之前，计算可能会被暂停。

每个横幅在本次会话内均可关闭，并链接到 添加支付方式。

组织计费页面

每个组织在 /orgs/{id}/billing 都有一个计费页面，可从组织的导航访问。 当用量数据可用时，它会按维度渲染一个 已用 / 额度 条形图 （低于 80% 为绿色，80–95% 为琥珀色，达到或超过 95% 为红色）， 外加一个可选的预计周期末标记、一条预计账单行，以及当前套餐和支付方式。

管理计费

自助计费已上线。一旦有支付方式在案，组织计费页面 （设置 → 计费）会显示一个 Manage billing 按钮， 它会打开 Stripe 托管的 Customer Portal。在门户中你可以：

• 更新或替换支付方式。
• 查看账单和收据。
• 编辑你的账单地址和税号。
• 取消。

在添加卡片之前，页面会改为显示一个 Checkout 按钮 （添加支付方式）；两者互斥。

**谁可以操作：**仅限组织 owner 或 billing 角色 —— 而非 admin、member 或 viewer。

作为参考，控制平面暴露：

POST /v1/billing/portal-session → { url }

它返回一个指向 Customer Portal 的 URL；门户之后总是将你带回 组织计费页面。

按项目成本（showback）

计费页面包含一个 Cost by project 卡片，将你的用量按项目细分。 它按项目报告四个计量维度：

一个 Include credits & discounts 开关会在毛额和净额视图之间切换 —— 净额视图会按比例分摊免费额度和批量折扣。它是一个显示视角： 页脚始终显示毛额小计、免费额度、批量折扣和净额总计。

数据是按天粒度的：周期以一个完整的起始日期 （YYYY-MM-DD）作为键。用量取自一个全局计量存储， 因此即使项目被删除后，其成本仍然可见。

计费状态

计量用量按项目收集，按组织聚合，并通过 Stripe 按 定价合约 开具账单：

• 处于每月免费额度之内的用量不收费；超出部分按单位计量， 对高用量自动应用批量折扣。
• 控制平面的计费端点（/v1/billing/customer）为用量横幅和 组织计费页面提供支撑 —— 它们从同一来源读取， 因此两者都反映当前周期的真实数字。
• 从组织计费页面添加支付方式，以解除免费套餐的项目上限， 并继续超出免费额度使用。

相关内容

• 组织 —— 用量汇总到的单位。
• 端点 —— 空闲挂起是保持 CU-小时较低的原因。
• 定价 —— 免费额度、单位费率和批量折扣。