订阅额度与 API 用量如何保持一致？

返回 工程项目复盘 目录

标准回答

会员与开发者 API 共享额度时，不能简单先读余额、调用模型、再减余额；并发请求可能同时看到同一余额。参考方案是先在事务中预留额度，执行后按可确认用量结算或释放，并为请求设置稳定身份。

账本记录额度来源、预留、实际消耗、退款或调整，余额由受约束的状态维护或可核对地计算。调用超时但上游可能已成功时，应进入待核对状态，不能随意重复扣款或直接认定免费。

支付或订阅回调需要验证真实性、处理重复和乱序，以订单或事件身份幂等落库，再驱动权限变化。此处描述可实现的设计原则，现有材料没有确认昆仑智能采用哪种支付方或完整账本实现。

追问与回答

幂等键相同但金额不同怎么办

同一键应绑定请求摘要；内容不一致应返回冲突，而不是复用旧结果或执行新扣款。

额度回滚是否等于删除原记录

更可审计的方法是记录补偿或释放事件并关联原请求，保留发生过什么；实际设计还需按账务规则实现。

易混淆点

• 使用前端展示余额作为服务端是否允许调用的依据。

参考资料

• PostgreSQL 事务隔离

内容来源

• Android 与 AI 工程 Wiki · 原条目 q144