YH. 周毅恒PERSONAL PORTFOLIO
菜单 +
← 返回项目列表
CASE STUDY / 02 / AI / IMAGE GENERATION

AI 图像创作平台

从一句提示词到图像生成,连接登录、充值与使用额度管理。

Next.js通义万象Supabase

打开交互 Demo ↗

内容类型技术案例与方案拆解
阅读重点架构 · 数据 · 失败边界
技术主线身份 · 状态 · 数据一致性
01 / FOLLOW THE REQUEST架构流程 · 节点详解
STEP / 01

请求校验

确认身份、提示词长度和生成参数。模型调用凭证仅由服务端持有。

POST /api/generations
{ prompt, size, request_id }
点击节点查看数据如何流动

场景与技术范围

基于 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 的应用后端,提供认证、数据库和存储能力。
NEXT CASE / 03

商业项目开发工作流 ↗