Subotiz 的 按使用量计费 用于根据客户的实际使用量收费，适用于 API 调用、AI Token、数据存储、课程完成次数等按用量收费的订阅场景。商户在定价中开启 按使用量计费 后，通过 API 上报客户的使用量，Subotiz 按照定价规则累计费用，并在计费周期结束或使用量达到 用量阈值 时自动扣费。
创建定价前，需要先创建对应的商品，并完成使用量上报的 API 接入。有关商品及定价的基本概念，请参阅 商品管理｜了解商品与定价 和 商品管理｜了解定价。
了解按使用量计费
按使用量计费 是定价模型中的一个开关，可与以下定价模型组合使用：
定价模型 |
计费方式 |
示例 |
|---|---|---|
固定价格 |
单价 × 实际使用量 |
$0.02 / 次，使用 1,000 次，费用为 $20。 |
套餐价格 |
实际使用量 ÷ 包含数量（向上取整）× 套餐价格 |
$10 / 1,100 单位，使用 2,500 单位，按 3 个套餐收取 $30。 |
阶梯价格 |
按实际使用量所在的价格档位计算，支持整体计价及阶梯计价 |
1–1,000 次 $0.02 / 次，1,001 次起 $0.01 / 次。 |
开启按使用量计费后，可选择以下扣费方式：
扣费方式 |
扣费时机 |
适用定价模型 |
|---|---|---|
按周期扣费（天、周、月、季度、年或自定义） |
每个计费周期结束时，按当期累计使用量扣费。 |
固定价格、套餐价格、阶梯价格 |
达到使用量阈值扣费 |
累计使用量达到 用量阈值 时自动扣费。 |
固定价格、套餐价格 |
达到使用量阈值扣费规则
选择 达到使用量阈值扣费 时，系统按以下规则扣费：
- 扣费时机： 客户累计使用量达到用量阈值时，系统按定价规则计算本次使用量对应的费用并扣费。
- 重新累计： 每次扣费后，使用量归零并重新开始累计。
- 每月自动扣费： 距离上次扣费满 1 个月、使用量仍未达到用量阈值时，系统按这段期间的实际使用量扣费一次；期间使用量为 0 时，系统不生成账单。
示例：
- 固定价格： $0.02 / 次，用量阈值 5,000 次。客户每使用 5,000 次，系统扣费 $100。
- 套餐价格： $10 / 1,100 单位，用量阈值 1,100 单位。客户每使用 1,100 单位，系统扣费一个套餐 $10。
提示： 使用套餐价格时，建议将用量阈值设置为等于包含数量或其整数倍。用量阈值小于包含数量时，每次达到阈值都会按一个完整套餐扣费。例如，套餐为 $10 / 1,100 单位、用量阈值为 500 单位，客户一个月使用 1,300 单位：达到 500 时扣费 $10，再达到 500 时扣费 $10，剩余 300 在满 1 个月时扣费 $10，合计 $30；同样的使用量按周期扣费时，合计 $20。
创建按使用量计费定价
- 进入商品管理： 登录 Subotiz 后台，前往 商品 > 商品管理。
-
开始创建定价： 找到需要创建定价的商品，根据商品当前的定价情况进入创建页面：
- 尚未创建定价： 在 定价数量 中点击 去创建。
- 已有定价： 点击商品进入商品详情，选择 定价 页签，然后点击 创建定价。
- 填写基础信息： 在 基础信息 中确认关联的 商品，然后填写定价 名称。定价名称对客户可见，并显示在结账页面和发票中。例如，为商品 AI 写作助手 创建定价，并命名为 API 按量计费。
- 选择周期性订阅： 在 价格配置 > 付费类型 中选择 周期性订阅。
- 选择定价模型并开启按使用量计费： 在 定价模型 中选择 固定价格、套餐价格 或 阶梯价格，然后开启 按使用量计费。
-
设置价格： 根据所选定价模型，在 价格配置 中设置价格：
- 固定价格： 输入每个使用单位的单价。价格最多支持 14 位小数，适用于 Token、API 调用等低单价场景。
- 套餐价格： 输入 套餐价格 及 包含数量，例如套餐价格 $10、包含数量 1,100 单位。
- 阶梯价格： 设置各使用量区间的价格档位，并选择整体计价或阶梯计价。具体配置方式请参阅《商品管理｜创建阶梯价格订阅定价》。
- 预览计费： 点击 预览计费，输入使用量，查看预计费用。预览金额不包含折扣与税费，仅供参考。
-
设置计费周期： 在 周期配置 > 计费周期 中选择扣费方式：
- 按周期扣费： 选择 天、周、月、季度、年 或 自定义。如选择 自定义，可将周期数量设置为 2–365，并选择 天、周、月、季度或年 作为周期单位。
- 达到使用量阈值扣费： 选择 达到使用量阈值扣费，然后填写 用量阈值。用量阈值的单位与定价的计量单位一致，扣费规则请参阅上方「达到使用量阈值扣费规则」。
- 配置试用期（适用于固定价格及阶梯价格）： 启用 设置试用期，并设置试用时长、试用类型（免费试用或付费试用），以及是否启用 试用期仅可享受一次。套餐价格开启按使用量计费时，可跳过此步骤。
-
填写更多信息： 在 更多信息 中确认 币种、填写 描述，并可选择填写 商户侧定价 ID。
- 币种： 商品定价使用店铺主货币。客户可使用其他支付币种付款，有关币种转换及汇率规则，请参阅《Subotiz Payments｜多币种支付说明》。
- 描述： 填写面向客户的定价描述，该描述将在结账页面和发票中显示。建议写明计量单位及扣费方式，例如 每使用 1,100 次扣费一个套餐。
- 商户侧定价 ID（可选）： 填写该定价在商户自有系统中的唯一标识（最多 100 个字符）。该 ID 将随相关订单和订阅数据一并返回，方便与自有系统对账。
- 配置定价权益： 在 权益 中启用当前定价需要提供的商品权益，并完成对应配置。
-
保存或激活定价：
- 点击 保存，创建定价并保持 未激活 状态。
- 点击 创建并激活，创建并立即激活定价。
注意： 只有商品和对应定价均处于 已激活 状态时，该定价才能用于新的销售和结账流程。
上报使用量
开启按使用量计费后，商户需要通过 API 向 Subotiz 上报客户的实际使用量。Subotiz 根据上报的使用量及定价规则累计费用，并按所选扣费方式自动扣费。具体接入方式，请点击创建定价页面中的 了解 API 接入，或参阅 Subotiz 开发者文档。
管理按使用量计费定价
已创建的定价支持后续编辑、激活或停用。修改已被交易或订阅引用的定价时，已有交易和订阅继续使用原有定价信息，更新后的定价配置将应用于后续创建的交易和订阅。
有关定价的编辑、激活及停用操作，请参阅 商品管理｜管理定价。有关版本机制及对已有订阅的影响，请参阅 商品管理｜商品与定价修改规则。
最佳实践
- 选择合适的扣费方式： 使用量稳定的业务适合按周期扣费；使用量增长较快或单期金额较高的业务，可使用达到使用量阈值扣费，提前回款。
- 合理设置用量阈值： 结合客户的平均使用量及单价设置阈值；使用套餐价格时，将阈值设置为包含数量或其整数倍。
- 清楚说明计费规则： 在定价描述中写明计量单位、单价及扣费方式，帮助客户在订阅前了解费用计算方式。
- 核对使用量上报： 定期核对上报的使用量与内部记录，确保扣费金额准确。
按使用量计费帮助商户根据客户的实际使用情况收费。结合固定价格、套餐价格或阶梯价格，以及按周期扣费或达到使用量阈值扣费，商户可以为 API、AI 及其他按量收费的业务建立灵活、透明的计费规则。