AI 生图产品
从零到一

1.1 产品定位

面向国内用户的 AI 生图平台，用户输入 Prompt 调用第三方 API（如 GPT-image2）生成图片，后期可能扩展至视频生成。

1.2 核心功能

1.3 开发资源

• 独立开发者（1 人）
• 前端技术栈：React（熟练）
• 后端技术栈：Python（通过 AI 辅助编写）
• MVP 目标：5–7 天上线

1.4 目标用户

• 国内用户为主
• MVP 阶段使用海外服务器（不需要备案），快速上线验证
• 有用户后迁移国内，正规运营

1.5 开发策略

2.1 必买项

2.2 免费项（MVP 阶段够用）

2.3 后续可能花钱的

2.4 账号注册清单

开工前需要注册的账号：

  ✓ Cloudflare 账号（DNS + R2 图片存储 + 前端部署）
  ✓ Vercel 账号（前端部署备选）
  ✓ Neon 账号（数据库）
  ✓ Railway 或 Vultr 账号（后端服务器）
  ✓ GitHub 账号（代码托管）
  ✓ Sentry 账号（错误监控）
  ✓ 虎皮椒账号（支付，可以 Day 5 再注册）
  ✓ 域名注册（Cloudflare 或 Namecheap）
  ✓ 中转站平台账号（充值 API 余额）

2.5 MVP 总启动成本

3.1 为什么选择前后端分离 + Python 后端

核心背景：开发者只会 React，后端代码由 AI 辅助编写。

为什么不用 Next.js？

为什么 Python + FastAPI 最合适？

# 一个完整的 API 接口，就这么几行，一目了然
@app.post("/generate")
async def generate_image(req: GenerateRequest):
    image_url = await call_provider(req.prompt)
    return {"url": image_url}

3.2 技术选型总览

3.3 前端技术细节

• Vite 替代 Webpack，开发服务器启动速度秒级
• TypeScript 提供类型安全
• Tailwind CSS 替代手写 CSS
• 状态管理：Zustand 或 React Context
• 路由：React Router · HTTP 请求：Axios

3.4 后端核心依赖

fastapi          → Web 框架
uvicorn          → ASGI 服务器
sqlalchemy       → ORM
alembic          → 数据库迁移
pydantic         → 数据校验
python-jose      → JWT 认证
bcrypt           → 密码加密
boto3            → R2/S3 存储操作
httpx            → HTTP 客户端
python-dotenv    → 环境变量管理

3.5 核心数据表结构

users            → 用户信息（id, email, nickname, avatar, created_at）
subscriptions    → 订阅记录（user_id, plan_type, start_at, end_at, remaining_quota）
orders           → 支付订单（user_id, plan_type, amount, status, paid_at）
transactions     → 交易记录（user_id, amount, type, created_at）
images           → 生成图片（user_id, prompt, image_url, provider_name, status, created_at）
api_providers    → 中转站配置（name, base_url, api_key, cost_per_image, is_enabled...）
quota_records    → 额度变更明细（user_id, change_amount, reason, created_at）
invite_records   → 邀请关系（inviter_id, invitee_id, created_at）[V2]
commissions      → 分润记录（inviter_id, from_user_id, amount, created_at）[V2]

4.1 模型返回的图片格式

方式 1：返回 Base64

{ "data": [{ "b64_json": "/9j/4AAQSkZJRgABAQ..." }] }

方式 2：返回 URL（临时链接，1–24 小时后失效）

{ "data": [{ "url": "https://xxx.com/image/xxx.png" }] }

4.2 为什么必须用 OSS

4.3 完整图片数据流转

4.4 整体架构图

4.5 R2 存储代码示例

import boto3
s3 = boto3.client("s3",
    endpoint_url="https://xxx.r2.cloudflarestorage.com",
    aws_access_key_id="your-key",
    aws_secret_access_key="your-secret")
s3.put_object(Bucket="images", Key=f"{user_id}/{uuid}.png", Body=image_bytes)

5.1 调度流程

5.2 中转站配置表

5.3 排序规则

优先级 1：is_enabled = true
优先级 2：error_count < 阈值
优先级 3：current_daily < daily_limit
优先级 4：cost_per_image 从低到高
优先级 5：同价格时按 priority 字段排序

5.4 自动熔断机制

连续失败 3 次 → 自动标记为「冷却中」，30 分钟内不再调用
30 分钟后 → 试探请求 → 成功恢复正常，失败继续冷却

5.5 注意事项

• API Key 绝对不要写在前端代码里
• 失败重试只扣 1 次额度
• 记录每次 API 调用日志
• 不同中转站图片质量可能不同，需手动测试
• 计费按实际中转站成本记录

6.1 完整定价表

6.2 毛利计算（API 成本 ¥0.08/张）

6.3 单价阶梯

6.4 用户转化路径

6.5 定价设计要点

• 体验包 ¥1.99 而非 ¥0.99：锚定免费额度的感知价值
• 加量包限 VIP：保护月卡营收
• 月卡月底清零：行业惯例
• 体验包/加量包永不过期：避免投诉

7.1 额度规则

7.2 扣费优先级

体验包/加量包（永久）→ 月卡 → 免费额度
原因：先消耗永久的，再消耗会过期的

7.3 注意事项

• 并发扣费：前端 disable 按钮；后端事务 + 行锁
• 生图失败退回额度：先调 API 成功再扣
• 额度变更记录要完整
• 免费额度不建议加水印：分享即免费宣传

8.1 核心规则

8.2 为什么 10%

• 给自己留涨价空间
• 毛利率保护（专业月卡毛利只有 46%）
• 行业标准：拼多多 5–10%、美团 8–12%

8.3 为什么设上限

8.4 为什么不能提现（V2）

8.5 防刷机制

• 被邀请人必须完成首充
• 同 IP/同设备不计入
• 自邀自检
• 分润 24h 延迟结算

9.1 JWT 认证流程

用户输入邮箱+密码 → POST /api/auth/login
  → 后端验证密码 → 生成 JWT Token → 返回给前端
  → 前端存 localStorage → 每次请求 Header 带上
  → 后端验证 Token 有效性

• 密码必须用 bcrypt 加密
• JWT Token 7 天过期
• MVP 只需邮箱 + 密码

9.2 防刷策略

10.1 支付渠道对比

10.2 支付流程

用户点击"购买" → 前端 POST /api/payment/create
  → 后端创建订单 → 调用虎皮椒 API 生成支付链接
  → 前端跳转支付（微信/支付宝扫码）
  → 支付成功 → 回调验证签名 → 核对金额 → 更新订单 → 增加额度

10.3 注意事项

• 回调验证必须做
• 幂等处理：同一订单只能处理一次
• 订单 30 分钟过期
• 每天对账

11.1 部署架构

11.2 域名与备案

MVP 阶段：注册 .com 域名，不需要备案。

V2 阶段：购买国内服务器 → ICP 备案（1–2 周）→ 公安备案。

11.3 监控与备份

• 数据库：Neon 自动备份 + 每周手动 pg_dump
• 代码：GitHub 私有仓库
• 每月一次恢复演练

12.1 AIGC 内容审核

• 维护敏感词库
• Prompt 先过敏感词过滤
• 命中敏感词直接拒绝

12.2 必要法律文件

12.3 经营资质与税务

• MVP 用海外服务器，暂不需 ICP 备案
• 月收入超 ¥5000 建议申报个税
• 月收入稳定过万建议注册个体工商户

13.1 获客渠道

13.2 客服方案

• 微信群或邮箱客服
• FAQ 页面覆盖常见问题
• 承诺 48h 内回复
• 已消费额度不退，未消费 7 天可退

14.1 MVP（Day 1–7）

14.2 V2（100+ 用户）

• 邀请分润系统
• 手机号登录 · 邮箱验证
• 内容审核 · Redis
• 迁移国内 + ICP

14.3 V3（月营收过万）

• 邀请提现 · 企业付款
• 完善风控
• 视频生成 · 微信登录

15.1 固定成本（MVP）

15.2 收入预估

15.3 盈亏平衡分析

ai-image-app/
├── frontend/
│   ├── src/
│   │   ├── pages/       Landing | Login | Create | History | Pricing | Dashboard | Admin
│   │   ├── components/  PromptInput | ImageCard | Gallery | PricingCard | Status | Navbar
│   │   ├── api/         client (Axios+JWT) | auth | generate | images | payment | quota
│   │   ├── store/       userStore (Zustand)
│   │   └── utils/       poller
│   ├── package.json | vite.config.ts | tailwind.config.js
│
├── backend/
│   ├── app/
│   │   ├── main.py (FastAPI + CORS) | config | database | models | schemas
│   │   ├── routers/     auth | generate | images | quota | payment | admin
│   │   ├── services/    provider_router | quota_service | r2_storage | sensitive_words
│   │   ├── adapters/    base | openai_compatible
│   │   └── middleware/  rate_limit
│   ├── data/            sensitive_words.txt
│   ├── requirements.txt | .env | Dockerfile
│
├── docker-compose.yml | .gitignore | README.md