场景与技术范围
基于 Next.js 与 Supabase 构建图像生成产品,接入阿里云百炼的通义万象,包含登录、用户后台、充值和使用次数控制;支付接入采用 7Pay。
技术重点是将一次模型调用放进完整的用户与额度体系。文生图接口能够返回图片,并不意味着付费流程与并发扣费就已正确。本页将两者分别讨论。
系统分层
| 模块 | 模块职责 | 工程关注点 |
|---|---|---|
| Next.js | 落地页、用户后台与业务接口 | 服务端参数校验与错误映射 |
| Supabase | 登录与数据存储 | 用户数据隔离、事务与唯一约束 |
| 通义万象 | 文本生成图像 | 异步任务、超时与失败状态 |
| 7Pay | 充值支付 | 回调验签、订单匹配、重复通知 |
客户端发出生成意图,服务端统一完成身份校验、额度判断和模型调用。前端展示的额度只是视图,服务端账本才是可信来源。
数据与状态设计
账本设计逐条记录额度变化,并通过业务标识关联生成请求和支付订单:
Generation(id, user_id, request_id, task_id, status)
CreditLedger(id, user_id, delta, reason, reference_id)
PaymentOrder(id, user_id, amount, status, provider_id)
unique(user_id, request_id)
unique(provider_id)
其中唯一约束用于防止同一生成请求或同一支付订单被重复处理。生成记录、充值订单与额度账本通过业务标识关联。
关键工程问题
并发扣费与生成失败
额度管理流程分为「预留 → 生成 → 结算」。在事务中检查可用额度并预留;明确成功后结算,明确失败后释放。超时不一定代表模型任务失败,应保留任务标识并查询,避免重复调用和错误退款。
transaction:
assert available_credits >= cost
insert reservation(request_id, cost)
submit_model_task()
succeeded → settle once
failed → release once
unknown → reconcile later
支付回调与密钥隔离
支付回调需要验证签名、订单归属与金额,再幂等地更新状态和充值账本。不要仅根据浏览器跳转到成功页就增加额度。模型 API Key 和高权限数据库凭证不能进入浏览器包。
验收标准
- 未登录、余额不足、非法尺寸与超长提示词得到明确错误。
- 并发提交不会使可用额度变为负数。
- 重复支付通知只产生一次充值,金额不匹配不会到账。
- 模型超时与失败均可追踪;失败补偿不会执行两次。
- 用户无法查看或下载其他用户的私有生成记录。
参考资料
- DiffSynth-Studio:图像与视频生成工具集,提供扩散模型推理和训练相关实现。
- Supabase:基于 PostgreSQL 的应用后端,提供认证、数据库和存储能力。