商业化与交付

API 接口如何收费?计费模式、账单算例与系统选型清单

用 10 万次调用比较按次、次数包、基础费加超额及阶梯计费,梳理失败、超时、重试的收费规则,附账单字段、支付幂等与采购验收清单。

API 计费系统先核对六类能力

运营收费 API,需要把收费规则、调用计量、套餐额度、订单支付、账单明细和异常处理连起来。采购时,应能选中一条调用记录,说明它属于哪个应用、采用哪版规则、为何扣减,以及最终进入哪份账单。

能力 需要回答的业务问题
收费规则 哪些接口收费,计量单位是什么,失败和重试如何处理?
调用计量 哪次调用属于哪个客户、应用和接口,结果如何?
套餐与额度 购买后得到多少次数或余额,何时生效、何时失效?
订单与支付 交易是否成功,付款后是否只入账一次?
账单与明细 用量、单价、扣减和调整能否互相核对?
异常处理 超时、漏记、重复扣减和退款由谁处理,依据如何保留?

本文的定价、规则、字段和流程是通用设计演示,金额为人民币假设值,并非 YesAPI Pro 报价,也不表示所有套餐支持相同实现。 产品已确认的计费范围放在文末;下列规则可直接整理为采购与演示需求。

先选收费模式,再比较同一用量的费用

按次收费适合用量波动的服务,次数包便于提前采购预算,基础费加超额适合有持续服务成本的业务。量大优惠还要分清“分段累进”和“全量折扣”,两者算出的金额不同。Stripe 的API 调用定价说明也将按次、分级用量和订阅加用量列为常见模式。

常见模式 费用如何形成 适用需求 采购时重点核对
按次计费 计费次数 × 单价 用多少付多少 最小扣费单位、预付或后付、余额不足处理
预付次数包 先买固定次数,用一次扣一次 希望提前控制支出 有效期、接口范围、叠加顺序、余量结转
基础费加超额 固定费用含一定次数,超出部分另计 持续服务加弹性用量 基础费周期、包含次数、超额单价、自动续订规则
分段累进 每段用量按该段单价计费,再求和 按使用规模逐段让利 各段边界、跨段计算、账期何时重置
全量折扣 总量达到某档后,全部次数使用该档单价 按最终规模统一报价 定档时点、临界点费用变化、预扣后如何调账

同样 10 万次调用,账单如何计算

统一假设:一个应用在一个月内产生 100,000 次应计费调用,只使用一种 API;所有模式均无额外费用、优惠或退款。这里比较 API 运营方向调用客户收取的使用费,与采购平台软件的授权费用分开。

模式 本例规则 计算 本月费用
按次计费 每次 ¥0.01 100,000 × 0.01 ¥1,000
次数包 ¥800 购买 100,000 次,当月全部使用 购买 1 包,扣减 100,000 次 ¥800
基础费加超额 ¥300/月含 20,000 次,超额每次 ¥0.008 300 + (100,000 − 20,000) × 0.008 ¥940
分段累进 第 1–20,000 次 ¥0.01;第 20,001–100,000 次 ¥0.008 20,000 × 0.01 + 80,000 × 0.008 ¥840
全量折扣 月总量 1–20,000 次单价 ¥0.01;20,001–100,000 次单价 ¥0.008 100,000 × 0.008 ¥800

分段累进保留前 20,000 次的原单价,全量折扣则重算全部用量。Stripe 的分级定价文档明确区分了这两种方式。

全量折扣要特别验算临界点:本例中 20,000 次为 ¥200,20,001 次为 ¥160.008;若月末统一保留两位小数,则为 ¥160.01。总量增加,费用反而下降。这可以是有意设计的优惠,但应写进定价条款。对 ¥0.008 这类不足一分钱的单次费率,还要约定累计精度与舍入时点,避免逐次四舍五入导致账单偏差。

表中次数包恰好用完。实际选型还应比较低用量月份:买了 100,000 次、只用了 20,000 次时,本期支付仍是 ¥800,剩余次数能否使用取决于有效期与结转条款。不能只拿标称单价比较成本。

用一张规则表定义哪些请求收费

下面以“返回有效数据才收费”的查询 API 为例。收费结论同时依赖业务结果与请求身份,不能只根据 HTTP 状态码判断。

请求结果 本例约定 明细中应留下的依据
成功返回有效数据 计 1 次 请求标识、接口、应用、成功结果、规则版本
参数错误 不收费 参数校验结果、错误类型
无调用权限 不收费 鉴权或权限检查结果
成功执行但返回空数据 不收费 业务未命中标识,区分查询失败
平台确认上游超时,未交付业务结果 不收费;已预扣的额度应回退 超时记录、预扣与回退记录
同一业务请求在约定窗口内重试 校验业务身份和参数后复用原计费结论,不重复扣减;新业务请求按自身结果计费 业务去重标识、各次请求标识、原始计费记录
平台缓存命中并返回有效数据 计 1 次;调用方本地缓存未请求平台则为 0 次 缓存命中标记、返回结果与计费结论

客户端超时只说明调用方没有及时收到响应,服务端可能已经成功。应允许用请求标识查询最终结果;在结果未确认时,避免把每次重试都当成新的收费业务。去重窗口多长、相同标识配不同参数如何处理,也要写进接入文档。

空数据与缓存的收费策略可以按业务调整。例如,核验服务可能把“未匹配”视为已交付的有效核验结论。应先定义客户购买的结果,再让文档、计量和账单采用同一规则。

从下单到出账,让每笔扣减能追溯

计量记录说明发生了什么;额度说明还能用多少;订单说明买了什么;账单说明本期如何计价。可按以下顺序设计演示和验收:

  1. 建立规则版本。 保存接口范围、单位、费率、成功条件和生效时间。套餐订单与调用计费均能追溯当时规则,避免改价后历史账单被重算。
  2. 下单并确认支付。 订单记录套餐、金额和交易状态。校验支付结果后,按交易唯一标识处理入账,重复通知只对应一次充值或额度发放。
  3. 激活套餐或额度。 记录生效时间、到期时间、可用接口与所属账户。多个应用共用额度时,写清共用范围和扣减顺序。
  4. 调用前检查权限与额度。 拒绝未授权、过期或额度不足的调用。需要先预留额度的接口,应在并发请求下校验不会超扣,并为失败设计释放机制。
  5. 按最终结果生成计量记录。 关联应用、接口、请求标识与规则版本,记录成功、失败、空数据、缓存或重试归类。
  6. 完成扣减或补偿。 同一计费事件只处理一次;预扣后的失败应释放额度。人工调整关联原记录,保留原因、依据和操作人。
  7. 汇总账单并核对。 按客户、账期和接口汇总用量,应用对应费率。次数包展示购买与消耗,后付费展示应付金额,修正以调整记录体现。

支付幂等与调用去重分别验收

支付通知可能重发,用户也可能重复点击购买。支付幂等要保证同一笔交易不会多次发放额度;调用去重要保证同一业务重试符合约定的收费次数。两者需要各自的标识和处理记录。

Stripe 的幂等请求文档提供了一种通用参考:创建或更新操作携带幂等键,以便安全重试。键的作用范围、保存时长和参数一致性校验都需要明确。

支付成功但通知延迟时,应能查到订单当前状态,并通过支付渠道核对后补齐入账。用户关闭支付页面、重复通知、补单或退款,也应保留处理依据。

账单要同时展示计算结果与核对入口

沿用基础费加超额的假设,本月 100,000 次应计费用量可以拆成以下账单行:

账单项目 用量与费率 金额
月基础费 ¥300,包含 20,000 次 ¥300
套餐内调用 20,000 次,不另收费 ¥0
超额调用 80,000 次 × ¥0.008 ¥640
本期合计 100,000 次应计费用量 ¥940

“应计费用量”与“原始请求数”应分别展示。例如,一组互斥归类的演示记录为:112,000 个原始请求,扣除 8,000 个不收费的失败或空结果、4,000 个去重重试,得到 100,000 次应计费用量。客服用这一步解释两边数字为何不同。

建议保留的账单或明细字段 示例与用途
客户、应用与接口 customer_demo、app_demo、order_lookup,定位费用归属
账期与时区 2026-09-01 00:00 至 2026-10-01 00:00,Asia/Shanghai,采用左闭右开区间
规则版本与订单 query-v1、order_demo_001,核对购买条款与计费依据
原始量、排除量与应计费量 112000、12000、100000,核对汇总口径
分段用量、单价与金额 套餐内 20000 次、超额 80000 × 0.008 = 640,复算费用
请求标识与业务去重标识 前者定位每次请求,后者关联同一业务的重试
结果与扣减记录 成功、超时、缓存等归类,以及额度变化和回退依据
调整与结算状态 原记录、调整原因、操作人、应付与已付金额,处理争议

保存这些核对字段不等于保存完整业务报文。请求参数与响应中可能含敏感数据,应按排错需求确定脱敏方式、访问权限与保留期限。

预算告警与费用突增,按同一条明细排查

采购时可以把“预算达到 80% 提醒、达到上限后按约定停用或允许超额”列为验收需求。还要区分额度上限、瞬时限流和费用预算:每分钟限流不能保证月度费用不超支。

假设账单从 ¥940 突增到 ¥1,580,先核对是否仍为同一规则和账期。在本例超额费率下,差额 ¥640 对应 80,000 次额外计费用量。接着按应用、接口、日期定位新增部分,并沿明细排查:

  • 原始请求与计费用量一起增加: 检查业务增长、定时任务频率、测试与生产是否共用应用。
  • 原始请求增加,重试占比上升: 检查上游延迟、超时设置、退避策略和业务去重标识。
  • 用量相近,费用增加: 检查套餐是否到期、费率版本是否变更、优惠是否结束。
  • 客户日志与账单不一致: 统一时区、账期和结果口径,再抽查具体请求与调整记录。

如果差异来自计量错误,应关联原账单做更正,保留修正前后金额。财务与客服需要可复核的依据。

采购演示带上这八个验收场景

场景 需要核对的结果
正常购买、付款并调用 订单金额、到账次数、有效期与剩余额度一致
成功、参数错误、无权限、空数据 每种结果均符合已确认的收费表
上游超时、客户端超时后重试 可查询最终结果,预扣回退与重试收费有依据
同一支付通知重发,用户退出支付页 同一交易只入账一次,订单最终状态可核对
多个应用并发使用最后一份额度 共用与隔离规则明确,不超扣、不重复入账
额度不足、套餐到期、跨计费档位 拒绝或超额规则正确,临界点金额可复算
抽查一条调用并汇总本期账单 客户视图、后台明细和账单使用同一计费口径
退款、人工补单或计量更正 关联原订单与记录,保留操作人、原因和调整金额

将演示结果记为“已验证”“需要配置”或“需要开发”,并写入交付范围。这样才能把采购需求落实为可执行的验收条件。

按计费业务与套餐边界选择 YesAPI Pro

YesAPI Pro 已列明的 API 计费商城能力包括付费套餐、订单、在线支付和调用流量计费。当前六套餐的边界如下:

产品套餐 已确认的计费与运营范围 适合进一步评估的需求
Java 三套餐:旗舰版私有部署、旗舰版私有部署 + 源码、招投标专享版 均包含 API 计费模块;源码与交付范围按套餐区分 已有 Java 团队,需要私有部署或源码集成
PHP 标准版接口开放 提供接口开放与管理,不包含 API 计费 当前先解决开发者接入、文档与权限
PHP 旗舰版接口收费 包含 API 计费平台、套餐、订单与支付;列明支付宝 / PayPal 对接 运营自有 API 服务
PHP 多商户版第三方平台 在旗舰版基础上增加服务商入驻、接口上架、收益结算与提现 接入第三方 API 服务商并运营平台

服务商结算与提现仅列为 PHP 多商户版能力。具体收费模式、失败计费策略、重试去重和预算控制,需要按上述规则表验证;“包含计费模块”不能直接推定这些规则全部内置。

可分别查看 Java 产品与交付套餐、PHP 三套餐比较和多商户服务商平台。带上一种实际 API、预计月调用量、收费规则表与八个验收场景,预约一次围绕账单核对的产品演示,确认从下单到调用扣减的完整流程。

参考资料

以下为本文引用的官方资料。文中的通用示例与产品套餐能力分别说明。

接下来,如何选型?

把收费规则,带进套餐评估。

Java 三套餐包含 API 计费;PHP 从旗舰版起提供计费与支付。通用收费算例需在实际演示中逐项核对。

  • 准备成功、失败、空结果、超时和重试的预期扣费表。
  • 核对套餐、支付通知与调用记录如何对应。

需要把这些问题落到项目上?

整理目标接口、技术栈与部署边界,预约一次有重点的产品演示。

预约产品演示
↑