一、【业务场景】

客户使用用户个人令牌调用 API 接口时，需要了解账套剩余调用次数、各用户及令牌的使用情况，并在免费次数不足时购买调用次数，保障业务正常使用。

二、【功能介绍】

问题编号：EAR-268634

更新范围：乐檬零售后台web

本次系统升级迭代，在用户个人令牌中新增“调用与计费”页签，主要功能包括：

1. 支持查看 API 调用额度
   展示当前可调用次数、本月已调用次数、免费剩余次数及付费剩余次数。每个账套每月享有 10 万次免费 API 调用额度，账套内所有用户及个人令牌共享使用。

2. 支持充值调用次数
   提供 120 元／50 万次、200 元／100 万次、360 元／200 万次三档套餐，有效期均为 1 年。支持查看充值记录及已充值次数包的剩余次数、到期时间和使用状态。

3. 支持查询调用趋势及消费记录
   支持按月份、API Key 等条件查询每日调用趋势及消费明细。账套所有者可查看全账套数据，其他用户仅可查看本人数据。

三、【使用说明】

功能入口：乐檬零售后台web → 档案 → 用户中心 → 用户个人令牌 → 调用与计费

进入“调用与计费”页签，可查看账套调用额度及次数包使用情况，选择筛选条件后点击“查询”，查看调用趋势和消费记录。

需要增加调用次数时，点击“充值次数”，选择套餐并跳转至费用中心结算台，完成“令牌调用服务费”支付后，充值次数自动计入当前账套。点击“充值记录”可查看历史充值明细。

四、【注意事项】

• 免费次数每月 1 日重置，上月未使用次数不结转。

• 优先扣减当月免费次数，免费次数用尽后，按充值成功时间从早到晚扣减有效次数包；已过期次数包不可继续使用。

• 充值次数由当前账套共享，不归充值用户个人所有，有效期自支付成功时起算。

• 可调用次数用尽后，API 调用将受限，不产生欠费或超额费用；充值支付成功后自动恢复可调用状态。

• 本期仅支持 API 调用次数管理，不涉及消息通知次数及账户余额。