模型与应用

Yaoledge

会员权益、模型授权与用量账本

Yaoledge 将会员权益、模型调用授权与费用记录关联到同一账户。用户管理会员、API Key 和服务积分；服务端在授权时保存费率，收到匹配的最终用量后结算。独立对话应用从这里取得身份和历史容量权益，各端共用同一套商业规则。

把一次模型调用解释成明确的账户变化 调用前保存获准模型和费率，调用后根据完整终态计价，并在同一事务中记录额度、积分与费用明细。用户可以沿原请求与入账日期理解变化，目录更新不改写历史。

同一账户，服务开发者调用与浏览器对话

用户通过既有身份服务登录，得到产品会话。开发者可以创建和撤销自己的 API Key；对话服务则取得另一类绑定当前会话、有效期十五分钟的模型凭据。凭据用途分别管理，模型费用统一归属原账户。

新调用需要有效凭据，并且有可用会员额度或可支出的服务积分。没有会员也可用积分调用模型，但对话应用另有当前会员与历史容量要求。退出、撤销或到期会限制后续调用，已经获准的请求仍按其原始授权结算。

开发者先登录自己的账户，查看当前模型报价和可用资源，再创建用途明确的 API Key。完整密钥只在创建时返回，列表只展示当前账户的管理记录；撤销密钥限制后续准入，不删除已经获准请求的授权与费用记录。

调用前看到的报价帮助理解选择，真正结算仍以原授权保存的费率为准。调用结束后，应按原请求核对终态用量、完整费用及其额度和积分分摊，而不是用当前目录价格反算历史费用。

授权事务保留账户、凭据、模型、供应商目标和价格快照。此时不预扣资金，也不预留某个费用上限；并发请求与延迟到达的结果可能超过准入时看到的资源。目录或会员状态随后改变，不会重写原请求的费率。

最终通知必须匹配原授权。服务分别计算未缓存输入、缓存输入和总输出的费用，合计后一次向上取整到百万分之一元。推理输出已包含在总输出中，不另计一遍。

账户变化、消费记录、每日汇总和原请求关闭在同一事务提交。重复通知读取已完成结果，不再次记账。核对一笔费用时，价格看授权时的费率快照，额度与积分分摊则看结算时的账户状态。

有效会员的费用先使用可用额度，再使用服务积分，剩余部分保留为尚未补足的额度占用。积分余额始终非负；后续额度恢复或新增积分可以消化超额。消费记录保留完整费用及其分摊，不因之后调整容量而改写。

下面沿用设计中的规则示例：容量为 10，已有占用 6，积分为 3，新费用为 10。先消耗 4 单位可用额度、3 单位积分，另外 3 单位形成超额；随后发放 5 单位积分，其中 3 抵扣超额，2 留在余额中。这些数值不是运营数据。

规则示例：金额采用同一示例单位
时点	额度占用	积分余额	可用额度／超额
费用入账前	6	3	可用 4
10 单位费用入账后	13	0	超额 3
再发放 5 单位积分后	10	2	可用 0，超额 0

首次会员生效时，可用额度从零开始，在有效期内按七天窗口逐渐恢复。已满的额度不会继续储存未来恢复量，非会员时间不产生恢复。已有超额不会因开通会员而消失，历史容量和额度上限采用当期冻结的权益。

续费把新条款追加到原到期时间之后；升级在支付确认后切换到新会员周期。取消按原购买价格与剩余完整天数计算返还服务积分，未开始的完整未来周期可全额返还。该结果是积分返还，不是现金退款。

取消后尚在途的模型费用仍可能消耗返还积分或形成超额。会员过期、取消或降档不会删除对话历史，是否允许新的对话由当前权益和历史容量共同决定。

用量视图提供最近七天或三十天的费用，按上海时间的账本入账日归集。午夜前开始的推理，如果午夜后才完成结算，计入后一天。总费用、额度承担和积分承担都与原消费记录一起更新，不另设后台重算账本。

购买积分、会员返还和超额抵扣会保留独立记录，但不计入模型费用汇总。零金额并不代表零次请求，读取失败也不能显示成零支出。用户可沿报表的日期范围继续查询明细，无需先下载全部历史。

调查会员或积分时，先定位原购买及其冻结报价、原付款关系和实际权益周期，再看当前账户。更新目录改变后续报价，不修改已经购买的周期；续费的未来条款也不会提前覆盖当前周期的容量。

一笔跨期费用同时涉及两个时点：价格取原请求授权时的快照，额度和积分分摊取费用到达并结算时的账户状态。日报再按上海时间的实际入账日归集。因此，取消会员后的积分变化，或午夜后的新增费用，需要回到原请求与消费明细解释。

运营人员可以查询账户、购买、原推理与用量，限制新的商业操作，直接设置一段会员权益，或按唯一赠额标识发放积分。赠额重复提交返回原结果；直接设置会员是新的替换，不自动延长旧期限，也不伪造支付或退款记录。

核对重点包括价格变更后的原费率、重复通知下的一次记账、跨午夜归集、取消后的迟到费用，以及赠额回应丢失后的同标识查询。日志用于解释处理过程，金额结论仍来自账本；设计中的验证要求不等于已完成的实测。