all-in-aigc/aiwallpaper · 上手攻略

  • 仓库：all-in-aigc/aiwallpaper
  • 链接：https://github.com/all-in-aigc/aiwallpaper
  • 分类：ai
  • 作者：Tom
  • 更新：2026-08-26

这是什么

all-in-aigc/aiwallpaper 是一个开源 AI 壁纸生成 Web 应用，用户输入文字描述即可生成定制壁纸。核心技术基于扩散模型（推测为 OpenAI DALL-E 或 GPT Image API），产品层面是一套完整的 SaaS 前后端架构，集成了用户认证、支付、对象存储和数据库，适合作为"AI 生成式 Web 应用"的参考样板。

官方在线演示：https://aiwallpaper.shop

解决什么问题

市面主流 AI 壁纸工具（如 Higgsfield、Canva AI Wallpaper、Monica）大多是闭源 SaaS，用户无法自托管，也无法定制业务流程。该仓库则提供了完整开源实现，开发者可以：

  • 直接部署为自己品牌的 AI 壁纸服务
  • 替换图像生成后端（换用不同的 OpenAI 兼容 API 或本地模型）
  • 自定义支付流程、用户套餐和存储方案
  • 学习 Next.js 全栈 + OpenAI 图像生成的生产级架构

快速安装

环境要求

  • Node.js 18+（建议 20+）
  • pnpm（包管理器）
  • PostgreSQL（本地或云端均可）
  • OpenAI API Key（用于图像生成）
  • AWS S3 兼容存储（或 Vercel Blob / Supabase Storage 等兼容方案）
  • Clerk 账号（免费层即可，用于用户认证）
  • Stripe 账号（用于支付，测试模式可用）

部署步骤

# 1. 克隆仓库
git clone https://github.com/all-in-aigc/aiwallpaper
cd aiwallpaper

# 2. 安装依赖
pnpm install

# 3. 初始化数据库
# 在 PostgreSQL 中创建数据库，执行 data/install.sql 建表
# 数据库迁移文档参考：https://wiki.postgresql.org/wiki/Homebrew
# 或使用 Vercel Postgres：https://vercel.com/docs/storage/vercel-postgres
# 或使用 Supabase：https://supabase.com

# 4. 配置环境变量，创建 .env.local
cat > .env.local << 'EOF'
OPENAI_API_KEY="sk-..."
POSTGRES_URL="postgresql://user:pass@host:5432/dbname"
AWS_AK="your-access-key"
AWS_SK="your-secret-key"
AWS_REGION="us-east-1"
AWS_BUCKET="your-bucket-name"
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY="pk_test_..."
NEXT_PUBLIC_CLERK_SIGN_IN_URL="/sign-in"
NEXT_PUBLIC_CLERK_SIGN_UP_URL="/sign-up"
NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL="/"
NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL="/"
STRIPE_PUBLIC_KEY="pk_test_..."
STRIPE_PRIVATE_KEY="sk_test_..."
WEB_BASE_URI="http://localhost:3000"
EOF

# 5. 启动开发服务器
pnpm dev
# 访问 http://localhost:3000

核心用法

应用架构

Next.js 14 (App Router)
  ├── Clerk         → 用户注册/登录/会话管理
  ├── OpenAI API   → 图像生成（DALL-E 或 GPT Image）
  ├── PostgreSQL   → 用户数据、生成记录、订单
  ├── AWS S3       → 壁纸图片存储与 CDN 分发
  └── Stripe       → 付费套餐、订阅管理

壁纸生成流程（推测）

基于 README 推断的标准流程：

  1. 用户在前端输入文字提示词（prompt）
  2. 前端调用 Next.js API Route
  3. API Route 调用 OpenAI 图像生成 API
  4. 生成的图片上传至 AWS S3
  5. 图片 URL 和元数据存入 PostgreSQL
  6. 前端展示生成结果，支持下载

关键目录结构

aiwallpaper/
├── app/                  # Next.js App Router 页面
├── components/           # React 组件
├── lib/                  # 工具函数（OpenAI 客户端、Stripe 逻辑等）
├── data/
│   └── install.sql      # PostgreSQL 建表 SQL
├── .env.local            # 环境变量（勿提交至 Git）
└── package.json

Stripe 集成要点

Stripe 用于处理付费：需在 Stripe Dashboard 创建产品/价格，获取 STRIPE_PUBLIC_KEY 和 STRIPE_PRIVATE_KEY。支付回调和 webhook 处理逻辑在 API Route 中实现（具体实现需阅读源码确认）。

典型适用场景

  1. 快速搭建 AI 壁纸 SaaS：基于本仓库二次开发，去掉或保留 Stripe 接入自己品牌，部署到 Vercel
  2. 学习 Next.js 全栈工程：Clerk 认证 + PostgreSQL + AWS S3 + Stripe 四件套的标准组合
  3. OpenAI 图像 API 集成参考：查看 lib/ 或 API Route 中调用 OpenAI 的具体实现方式
  4. AI 应用商业化原型：已有支付闭环和用户系统的完整骨架

坑与注意

⚠️ README 信息量较少：该仓库 README 主要描述安装步骤，核心业务逻辑（如 prompt 处理、生成参数、分辨率选项、计费模式）需直接阅读源码确认。

⚠️ 依赖版本未注明：package.json 未在 README 中展示，Node.js / pnpm / PostgreSQL 具体版本需 clone 后查看。

⚠️ OpenAI API 费用：图像生成 API 按张计费，生成壁纸需控制用户调用频率，防止 API 费用失控。

⚠️ Clerk 和 Stripe 需要自行配置：两者均有免费开发层，但生产环境需升级付费套餐（Clerk 按月活用户计费，Stripe 标准费率 2.9%+0.3美元）。

⚠️ AWS S3 存储成本：大量用户生成图片后 S3 存储费用需预估，建议接入 S3 生命周期规则自动清理过期文件。

⚠️ 生产部署建议：推荐 Vercel 部署（与 Next.js 原生契合），数据库可选 Vercel Postgres 或 Supabase，存储可选 Vercel Blob 或 Cloudflare R2（费用更友好）。

与同类对比

项目 类型 开源 图像生成后端 支付 认证
all-in-aigc/aiwallpaper 全栈 SaaS ✅ OpenAI API Stripe Clerk
Higgsfield.ai 在线服务 ❌ 自有模型 订阅制 Google/Apple
Canva AI Wallpaper 在线服务 ❌ 合作模型 免费+付费 Canva 账号
Monica AI Wallpaper 浏览器插件 ❌ 合作模型 免费+付费 Google

核心差异：本仓库是唯一开源、可完全自托管、带支付闭环的 AI 壁纸应用，适合开发者二开而非终端用户直接使用。

一句话推荐结论

如果你想快速搭建一个可收费的 AI 壁纸 Web 应用，或想学习 Next.js 全栈 + OpenAI + Stripe 的生产级集成方式，这是目前 GitHub 上最接近"开箱即可商业化"的参考实现——部署到自己域名就是一款独立的 AI 壁纸 SaaS。

⚠️ README 完整度有限，核心业务逻辑（prompt 优化、图片尺寸、生成速率限制等）需阅读 app/ 和 lib/ 目录源码确认。