SuperAPI AI 工具集

autumn-gating

通用与其它

查看项目

更新于 10-16 07:16

技能介绍

用途:为产品加入用量追踪与功能门控,在用户执行受保护操作前检查其是否还有可用余额,并在操作成功后记录用量以扣减额度。

主要能力:提供 check 与 track 两类操作。check 用于功能访问校验,可传入 featureId 与 requiredBalance,返回 allowed 判断;也可用于门控布尔型(非计量)功能,如高级模型访问。track 在功能成功使用后记录用量并扣减余额。资料给出 TypeScript(autumn-js)、Python(autumn_sdk)与 cURL 三种调用方式,以及 React 的 useCustomer 钩子用于前端 UX 门控。

使用方式:配置位于 autumn.config.ts;若不存在,可运行 npx atmn init 登录并生成该文件。接入前先检测集成类型:若已挂载 AutumnProvider 与 autumnHandler,则可用 React 钩子;服务端校验必须始终使用后端 SDK。典型流程为 check -> 执行操作 -> track,且仅在成功完成后才 track。积分系统场景下,required_balance 会把消息数换算为积分,应操作底层功能(如 basic_messages、premium_messages)而非直接操作积分系统。

适用场景:需要按用量计量或限制访问的 SaaS 与 AI 产品,例如按消息条数计费的聊天机器人、按不同成本模型区分的多档功能、以及多功能共享同一积分余额的场景。

限制与注意:安全校验必须在服务端进行,前端检查仅用于展示与 UX,可被用户通过开发者工具绕过。feature ID 来自 Autumn 配置,当前用量与总额度可从 Customer 对象获取。文档见 https://docs.useautumn.com/llms.txt。其他具体定价与套餐细节资料未提供。