【免费下载链接】AgentXAgentX 致力于让小白也能无门槛通过自然语言打造属于自己的 Agent。AgentX 采用了自研 MCP 网关模型高可用组件打造高可用项目地址https://gitcode.com/gh_mirrors/agentx/AgentX点击查看免费下载AgentX 是一个让小白也能无门槛通过自然语言打造 Agent 的开源平台内置自研 MCP 网关与模型高可用组件。本文带你快速搞懂 AgentX 的计费系统Token 消耗如何计费、订单状态如何流转、如何用支付宝或 Stripe 完成充值适合刚接触 AgentX 的新手和普通用户。一、AgentX 计费是怎么运作的先搞懂这 4 个概念AgentX 的计费系统设计非常透明核心是把**商品Product与计费规则Rule**解耦任何一次扣费都能追溯到具体算法。理解下面 4 个概念就看懂了整个系统概念通俗解释举例商品 Product声明什么东西要收费并挂上价格GPT-4o Token 费用规则 Rule抽象的计费算法独立于业务按 Token 计费 / 按次计费用量记录 Usage Record每一次可计费事件的留痕本次消耗 1000 输入 Token账户 Account管理余额、累计消费的实体你的充值余额钱包运行时流程是一条闭环触发事件 → 找到商品 → 匹配规则 → 执行策略计算 → 记账扣费。比如你调用一次模型系统会按输入Token ÷ 100万 × 输入单价 输出Token ÷ 100万 × 输出单价计算费用从余额中扣除并写入用量记录。 官方示例某模型输入单价 5 元/百万 Token、输出单价 15 元/百万 Token一次消耗 1000 输入 500 输出 Token费用约为0.005 0.0075 0.0125元。设计细节可参考 docs/billing/计费.md其中service_id的语义规范解释了为什么模型调用、Agent 创建、API 调用能共用同一套计费框架。二、Token 消耗发生在哪对话计费流程拆解对普通用户来说Token 消耗几乎全部发生在对话环节。AgentX 在消息处理器中集成了透明计费流程如下发起对话→ 系统先做余额预检查余额为负时阻止本次对话并提示充值模型返回响应→ 统计本次的输入 Token 与输出 Token 数量自动扣费→ 生成唯一requestId基于会话 ID、用户 ID 和时间戳保证幂等不会重复扣费记账→ 用量和费用写入用量记录表账户余额实时更新。几个值得新手放心的设计✅透明计费扣费不打断对话流程同步对话和流式对话都支持✅优雅降级余额不足时不会报错崩溃而是收到一条账户余额不足请充值后继续使用的友好提示✅允许短暂透支预检查通过后计费时余额允许变为负数负数会触发低余额提醒。集成细节见 docs/billing/对话模块计费集成说明.md核心服务实现位于 BillingService.java。三、订单管理5 种状态看懂每一笔充值充值在 AgentX 中就是一笔订单。订单状态定义在 OrderStatus.java共 5 种状态状态含义你可以做什么待支付 PENDING订单已创建等待付款可支付、可取消已支付 PAID支付成功余额已到账可申请退款已取消 CANCELLED用户主动取消结束状态已退款 REFUNDED退款完成结束状态已过期 EXPIRED超过支付时限未付款结束状态订单管理的关键能力用户端通过GET /orders分页查询自己的订单GET /orders/{orderId}查看单笔详情对应 OrderController.java管理端管理员可查看全部订单、筛选退款前端管理页面在 app/(main)/admin/orders/page.tsx/admin/orders/page.tsx)订单类型区分充值订单与商品订单枚举见 OrderType.java。四、3 步完成充值支付宝 / 微信支付 / StripeAgentX 通过统一的支付抽象层接入多个平台支付宝、微信支付、Stripe 各有一个 Provider 实现AlipayProvider.java、StripeProvider.java支持二维码、网页、H5 等多种支付形式。第 1 步选择充值金额进入 设置 → 计费 页面billing 页面/settings/billing/page.tsx)选择预设金额或自定义预设档位10 / 50 / 100 / 200 / 500 / 1000元自定义范围最小¥0.01单笔上限¥100,000。第 2 步选择支付平台与方式支付宝 / 微信支付支持二维码支付QR_CODE、网页支付等扫码即付Stripe面向海外用户走网页支付并支持退款可用方式由后端GET /payments/methods动态返回未配置的平台不会展示。第 3 步等待支付确认前端会创建充值订单POST /payments/recharge生成二维码或跳转链接然后自动轮询GET /payments/orders/{orderNo}/status查询支付状态同时支付平台会异步回调POST /payments/callback/{platform}确认到账。余额到账后页面会显示充值成功的动画与 Toast 提示账户数据即时刷新。整个充值流程的交互实现可参考 RechargeFlow.tsx含选金额 → 选方式 → 出二维码 → 等待支付的状态机。五、常见问题 FAQQ1余额不足会发生什么对话前会预检查余额为负时阻止新对话并提示充值已进行中的对话不会中途报错而是收到友好提醒。Q2为什么我的余额可能是负数预检查通过后模型才响应若单次费用超过余额允许透支为负。负数余额会触发低余额提醒充值后即可恢复使用。Q3会重复扣费吗不会。每次计费都带唯一requestId做幂等校验同一请求重复提交只会计费一次。Q4支持退款吗支付宝与 Stripe 订单支持退款微信支付暂不支持退款操作由管理端发起订单状态会变为已退款。Q5怎么查我的消费明细计费页面内置用量明细页支持按商品、requestId、时间范围筛选并分页查看接口实现在 PortalUsageRecordController.java。六、想深入源码与文档地图资料路径计费系统总体设计docs/billing/计费.md计费系统开发文档架构与集成点docs/billing/AgentX计费系统开发文档.md对话模块计费集成说明docs/billing/对话模块计费集成说明.md通用计费服务AgentX/src/main/java/org/xhy/application/billing/service/BillingService.javaToken 计费策略ModelTokenStrategy.java按次计费策略PerUnitStrategy.java支付抽象层PaymentProvider.java价格配置键定义PricingConfigKeys.java前端计费页面agentx-frontend-plus/app/(main)/settings/billing/page.tsx/settings/billing/page.tsx)前端订单管理页agentx-frontend-plus/app/(main)/admin/orders/page.tsx/admin/orders/page.tsx)除了 Token 计费系统还预留了按次cost_per_unit、按时长、分层阶梯、存储用量等多种价格配置键未来 Agent 创建计费、API 调用计费都会复用这套框架无需改动核心业务表。七、加入交流社区对 AgentX 的计费、充值或 Agent 搭建有疑问可以扫码加入 AgentX 交流群和其他开发者一起讨论掌握 Token 消耗、订单状态与充值流程后你就可以放心地在 AgentX 上用自然语言构建自己的 Agent 了——余额够、账单透明、随时可查。赞分享【免费下载链接】AgentXAgentX 致力于让小白也能无门槛通过自然语言打造属于自己的 Agent。AgentX 采用了自研 MCP 网关模型高可用组件打造高可用项目地址https://gitcode.com/gh_mirrors/agentx/AgentX点击查看免费下载相关推荐如何玩转Novel-Plus会员系统从充值到订阅的完整指南如何玩转Novel Plus会员系统从充值到订阅的完整指南 Novel Plus是一个功能完善的多端小说CMS系统提供小说阅读、书架管理、会员订阅等一站式服后端CMS前端网页爬虫AI 写作如何高效使用wechat-app-mall实现微信小程序余额充值与管理功能如何高效使用wechat app mall实现微信小程序余额充值与管理功能 wechat app mall是一个功能强大的微信小程序开发框架提供了完整的余额充电商小程序前端移动开发One API支付集成在线充值功能全攻略One API支付集成在线充值功能全攻略 你是否正在为多模型API服务的付费管理感到头疼用户充值流程繁琐、配额管理混乱、财务数据分散——这些问题不仅影响用户后端API网关LLM 网关大模型上一篇AirCard Passcode Theme Creator 与 Universal FlasheriOS 锁屏密码键盘主题的设计与实现全解析下一篇JavaScript eval 函数完全指南执行代码字符串的原理、作用域陷阱与安全替代方案zh.javascript.info创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考