> For the complete documentation index, see [llms.txt](https://tinyhumans.gitbook.io/openhuman/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/billing-and-usage.md).

# 计费、成本与用量

通过 Stripe 和 Coinbase 管理套餐、积分和已保存卡片，并提供本地实时仪表盘，用于显示 token 用量、成本和预算控制。

OpenHuman 维护两本相关但彼此独立的账本。 **计费** 是你向托管后端支付的内容：套餐、信用充值、已保存的卡片和优惠券，全部通过 Stripe 或 Coinbase 结算。 **成本与用量** 是代理代表你花费的部分，按每次提供方调用在本地跟踪，因此你可以在账单到来之前看到（并设定上限）真实的 token 花费。

第一本在云端；第二本从不离开你的工作区。

***

## 第 1 部分：计费与支付

该 `计费` 域是一个轻量级 RPC 适配器。它包含 **没有自己的支付逻辑或状态**。每个操作都会转发一个经过身份验证的 HTTPS 调用到托管后端（`/payments/*`, `/coupons/*`），并原样返回 JSON 响应。授权、套餐归属和支付策略都在后端强制执行。缺失或无效的会话会直接得到后端的 `401`/`403` ；JWT 和卡片数据绝不会被记录。

在发起 HTTP 之前，适配器只做轻量输入校验：非空的套餐/优惠券/支付方式 ID，一个有限且为正的 `amountUsd`，以及一个网关白名单： `stripe` / `coinbase`.

### 套餐

提供三个层级，每个都有月付和年付周期：

| 层级      | 月付      | 年付        | 相对于按需付费的每次调用折扣 |
| ------- | ------- | --------- | -------------- |
| **免费版** | $0      | $0        | 无（按需付费基线）      |
| **基础版** | $19.99  | $199      | 每次调用便宜 50%     |
| **专业版** | $199.99 | $1,799.99 | 每次调用便宜 90%     |

更高层级与其说是解锁功能，不如说是降低了 **每次调用的加价** 相对于按需付费基线的成本。所有层级都拥有“访问全部内容”的权限；你购买的是更便宜的推理，而不是受限功能。

### 支付提供方

接入了两个网关，而且只有两个：

* **Stripe**：套餐购买（Checkout 会话）、客户账单门户、信用充值、已保存卡片管理（SetupIntents）和自动充值。
* **Coinbase Commerce**：加密货币收费，用于信用充值和年费计费。

`top_up_credits` 和 `create_coinbase_charge` 默认使用 `stripe` 网关和 `年付` 周期；空字符串或仅空白的网关会归一化为 Stripe。

### 信用额、充值与自动充值

除了订阅之外，你还持有一个 **美元信用余额**。你可以查看余额、翻阅交易历史，并通过任一网关充值。 **自动充值** （仅限 Stripe）当余额不足时，会从已保存的卡片重新充值；你可以查看并更新其设置，以及列出/添加/更新/删除已保存卡片。添加卡片会创建一个 Stripe SetupIntent；删除卡片被视为危险操作。

### 优惠券

优惠码会在后端兑换（`POST /coupons/redeem`），并且你可以列出当前已在你账户上兑换的优惠券（`GET /coupons/me`).

### 计费在应用中的位置

桌面端 **设置 → 计费** 面板是只读的。它显示当前套餐、促销余额和充值余额、剩余总资金、当前周期支出以及用量明细。按钮会链接到托管的网页 **计费仪表板**，这是管理套餐、充值、优惠券、卡片和发票的唯一地点。其他客户端可以通过下文所述的已认证 RPC 控制器访问相同的托管计费操作；它们不会作为代理工具暴露。

### RPC 接口

命名空间 `计费`，暴露为 `openhuman.billing_*` （16 个方法），例如 `billing_get_summary`, `billing_get_current_plan`, `billing_get_balance`, `billing_get_transactions`, `billing_purchase_plan`, `billing_top_up`, `billing_create_coinbase_charge`, `billing_get_cards`, `billing_create_setup_intent`, `billing_update_auto_recharge`, `billing_redeem_coupon`.

***

## 第 2 部分：成本与用量仪表板

该 `成本` 域完全是本地的。它会将每次提供方调用的 token 用量和计算出的美元成本记录到一个只追加的 JSONL 文件（`<workspace>/state/costs.jsonl`），在内存中维护每日/每月汇总，执行预算限制，并通过 JSON-RPC 提供一个 7 天仪表板。代理回合循环（在每次提供方调用后记录遥测）和仪表板处理器共享一个进程全局单例跟踪器，因此每次调用都只会被持久化一次。

### 实时 token 与成本跟踪

对于每次调用，每次调用成本会根据 token 数量和每百万 token 价格计算得出（将非有限或负价格钳制为 `0.0`）。当提供方返回权威的 `charged_amount_usd` 时，该值优先；否则 OpenHuman 会回退到已知模型的静态定价目录。用量按 UTC 分桶，按模型键入，并且 **提供方** 由 `provider/model` 前缀派生。全零用量载荷会被跳过，因此不报告用量的提供方不会抬高请求计数。

### 预算与执行

预算执行在 `[cost]` 配置块下进行设置：

| 设置                  | 默认值      | 角色                  |
| ------------------- | -------- | ------------------- |
| `enabled`           | `true`   | 门控 **仅执行**，不包括遥测    |
| `daily_limit_usd`   | `10.00`  | 每日硬上限               |
| `monthly_limit_usd` | `100.00` | 每月硬上限               |
| `warn_at_percent`   | `80`     | 警告阈值 `check_budget` |

`check_budget` 返回 `允许`, `警告` （已达到警告阈值）或 `超出` （超过每日或每月上限）。关键一点： **`enabled` 控制的是执行，而不是采集。** 当它为 `false`, `check_budget` 时，总是返回 `允许` ，并且硬上限关闭。代理仍会无条件记录用量，因此你的支出历史会持续累积，你可以在启用硬上限 *之前* 审阅它。若要隐藏面板，请设置 `dashboard.enabled = false`；若要清除历史，请删除该 JSONL 文件（它是本地的，从不离开工作区）。

### 7 天仪表板

设置 → **用量与限制** 托管成本仪表板（以及后台活动控制）。它会渲染 7 天的每日历史（缺失天数补零，最早在前）、token 用量图表、每月进度预测、预算利用率以及按模型的成本明细。仪表板配色使用每月预算的比例：条形在 `warn_threshold` （默认 `0.8`）时变为琥珀色，并在 `alert_threshold` （默认 `0.95`). `budget_utilization` 会被钳制为 `1.0` 以便显示，而状态则根据原始值计算。面板大约每 10 秒轮询一次，并显示“更新于 Ns 之前”的新鲜度提示。全局跟踪器尚未初始化时，会使用一个只读的回退跟踪器（共享同一个 JSONL 文件）为 UI 提供服务。

### RPC 接口

命名空间 `成本`，暴露为 `openhuman.cost_*`:

| 方法                       | 输入                          | 输出                        |
| ------------------------ | --------------------------- | ------------------------- |
| `cost_get_dashboard`     | 无                           | 7 天分桶、汇总指标、预算利用率/状态、按模型拆分 |
| `cost_get_daily_history` | `天数？` （默认 7，限制在 1 到 366 之间） | 按顺序排列的每日条目，最早的在前，缺口以 0 填充 |
| `cost_get_summary`       | 无                           | 实时会话 / 每日 / 每月成本摘要        |

这些内容也作为只读、默认开启的代理工具暴露出来，以便代理检查自己的花费。

***

## 成本与 token 压缩

因为成本跟踪的是 **真实 token 数量**，任何缩短提示词的做法都会直接降低支出。OpenHuman 的 [TokenJuice token 压缩](/openhuman/zh/gong-neng/token-compression.md) 会减少每次调用发送的 token 数量，而 [模型路由](/openhuman/zh/gong-neng/model-routing.md) 会把工作发给能够处理它的最便宜模型。两者都会在仪表板中表现为更低的柱状条和更慢的预算消耗。

***

## 另请参阅

* [token 压缩（TokenJuice）](/openhuman/zh/gong-neng/token-compression.md)
* [模型路由](/openhuman/zh/gong-neng/model-routing.md)