Aizemo Meter 使用与设计说明
本说明覆盖渠道接入、模型配置、转发适配、用户额度、算力 Key、计费、安全与权限设计。
1. 系统架构
用户算力 Key→模型组→统一模型→转发适配器→渠道凭据→上游 API
用户不接触上游真实密钥。系统按统一模型找到渠道、凭据和转发格式,再根据实际响应计量并扣费。
2. 渠道与模型
- 连接渠道后从模型接口同步所有上游模型。
- 每个模型必须完成类型、凭据池、转发格式、输入输出单位和价格。
- 只有配置完整、测试通过、状态启用的统一模型才能加入模型组。
- 转发适配器负责请求字段转换、异步任务轮询、响应提取和用量提取。
3. 额度与实时计费
用户可用额度 = 累计增加 − 累计减少/退款 − 累计消费。每次调用先检查余额,完成后按模型输入与输出计价规则执行数据库原子扣费。
用户额度为 0 时,该用户全部算力 Key 自动失效;充值后,未停用且未过期的 Key 可恢复。
4. 用户与算力 Key
- Key 使用
sk-azm-... 形式,完整密钥加密保存,可在用户密钥列表复制。 - Key 绑定用户与模型组,可设置独立消费上限、RPM 和有效期。
- Key 是否可用同时受用户余额、Key上限、有效期、账户状态和模型组状态控制。
5. 注册、登录与邮箱验证
- 登录使用账号或邮箱和密码。
- 注册、修改、找回密码、管理员新建或重置用户密码、导入用户均使用同一规则:6–128 个字符,不能全为空白。不强制混合大小写、数字和符号;已有密码仍可登录。
- 注册、修改密码和找回密码均发送真实的一次性邮箱验证码。
- 验证码由服务端生成并哈希保存,设有效期、发送频率和失败次数限制。
- 密码使用强密码哈希保存;登录成功签发安全会话,不在前端存储明文密码。
6. 权限设计
超级管理员可管理渠道、凭据、定价和系统设置;运营管理员管理用户、额度、Key与账单;代理可查看本人及邀请链全部层级下级的资料、调用日志和充值情况;普通用户只能访问自己的余额、Key和消费记录。所有敏感操作写入审计日志。
7. 代理邀请与充值总列表
- 管理员在用户管理中将账号角色设为代理,原有上下级关系保留。
- 代理登录后可复制专属邀请链接。用户通过链接注册并完成邮箱验证,上级自动固定为邀请人,注册角色默认为普通用户。
- 下级若也要发展用户,由管理员将其设为代理,再使用该下级自己的链接邀请。
- 用户管理默认包含所有层级下级,卡片显示直属上级,可点击“直属下级”逐层查看。
- 代理的调用日志和充值总列表仅包含本人及下级。用户详情中的 Key 保持脱敏;代理无权调整额度、编辑用户、审核充值、查看支付配置或上游凭据。
- 超级管理员和运维管理员仍查看全部数据。充值总列表展示订单、用户、直属上级、支付方式、金额、入账状态与时间,并支持筛选和分页。
8. 充值与支付配置
- 管理员进入“系统设置 → 支付配置”,启用在线充值,并配置支付宝或微信。收款码模式由管理员审核到账;官方商户模式由支付平台通知验签后自动到账。
- 普通用户从账户总览的“立即充值”或侧栏“充值中心”进入;管理员、代理从控制台侧栏“充值中心”进入。选择金额、支付方式,点击“立即充值”后扫码付款。
- 充值中心只为当前登录账户充值,仅展示本人的订单。收款码订单付款后需填写流水号并提交审核;页面显示待审核状态,不会自行增加余额。
- 跨用户订单查询与人工审核在“充值总列表”。超级管理员和运维管理员按权限查看全部记录;代理仅查看本人及递归下级,不能审核。
- 付款确认后自动刷新余额和订单状态。有欠费时优先偿还欠费。充值未开放时入口仍可见,页面会明确说明未开放原因。
9. 管理员重置用户密码
- 在“用户管理”找到目标用户,点击卡片或详情中的“重置密码”。输入 6–128 个字符的新密码(不能全为空白)并再次确认,点击“确认重置密码”。
- 超级管理员可重置其他用户;具有用户编辑权限的运维管理员可重置普通用户和代理,不能重置管理员。代理和普通用户无此权限。
- 成功后旧密码及全部旧登录会话失效,用户需重新登录。余额、模型组授权和算力 Key 保持不变。审计记录包含操作人与目标用户,不记录明文密码。
- 修改自己的密码仍从右上角“修改密码”进入,并完成邮箱验证。重置他人密码不会变更账号启用状态或邮箱验证状态。