Skip to content

xiaosanpao/hellow-test

Repository files navigation

VideoFly 🎬

一个生产级 AI 视频生成 SaaS 模板,基于 Next.js 15 构建,支持 Sora 2、Veo 3.1 等先进 AI 模型。

本模板帮助你在几分钟内搭建自己的 AI 视频生成平台,包含完整的用户认证、积分系统、支付集成和精美的 UI 界面。

✨ 核心特性

🎬 AI 视频生成

  • 多模型支持 - Sora 2、Wan 2.6、Veo 3.1、Seedance、Kie.ai
  • 多种模式 - 文本转视频、图片转视频、视频增强
  • 智能积分系统 - FIFO 积分消耗,支持冻结/结算/释放
  • 实时状态追踪 - 生成进度实时更新

🎨 现代化 UI

  • Tailwind CSS 4 + shadcn/ui - 精美可定制界面
  • 深色主题 - 专为视频创作场景优化
  • 流畅动画 - Framer Motion 动画效果
  • 响应式设计 - 完美支持移动端

🏢 企业级架构

  • Next.js 15 - 最新 App Router 架构
  • React 19 - 最新 React 特性
  • Drizzle ORM - 类型安全的数据库操作
  • Better Auth - Google OAuth + Magic Link
  • Creem + Stripe - 双支付渠道支持

🌍 国际化

  • 多语言支持 - 英语、中文无缝切换
  • SEO 优化 - 元数据自动生成
  • 本地化路由 - /en//zh/ 前缀

🚀 快速开始

环境要求

  • Node.js 18+
  • pnpm 9+
  • PostgreSQL 数据库

安装

# 克隆仓库(使用模板仓库)
git clone https://github.com/zifeixu85/videofly-template.git your-project
cd your-project

# 安装依赖
pnpm install

# 配置环境变量
cp .env.example .env.local
# 编辑 .env.local 填入你的配置

# 初始化数据库
pnpm db:push

# 启动开发服务器
pnpm dev

访问 http://localhost:3000 查看效果。

一键部署

Deploy with Vercel

📁 项目结构

videofly/
├── src/
│   ├── app/                  # Next.js App Router 页面
│   │   ├── api/              # API 路由
│   │   │   ├── v1/           # REST API v1
│   │   │   ├── auth/         # Better Auth 端点
│   │   │   └── webhooks/     # 支付 Webhook
│   │   └── [locale]/         # 国际化页面
│   ├── ai/                   # AI 提供商抽象层
│   │   └── providers/        # Evolink、Kie 实现
│   ├── components/           # React 组件
│   ├── config/               # 配置
│   │   ├── credits.ts        # 积分/模型定价
│   │   └── pricing-user.ts   # 用户定价配置
│   ├── db/                   # 数据库
│   │   ├── schema.ts         # Drizzle schema
│   │   └── index.ts
│   ├── lib/                  # 工具函数
│   │   ├── auth/             # Better Auth 配置
│   │   └── storage.ts        # R2/S3 存储
│   ├── payment/              # 支付集成
│   ├── services/             # 业务服务
│   │   ├── credit.ts         # 积分系统
│   │   └── video.ts          # 视频生成
│   ├── stores/               # Zustand 状态管理
│   ├── hooks/                # React Hooks
│   ├── i18n/                 # 国际化
│   └── middleware.ts
├── scripts/                  # 工具脚本
├── docs/                     # 文档
└── public/                   # 静态资源

🛠 技术栈

类别 技术
框架 Next.js 15 (App Router)
运行时 React 19
语言 TypeScript
数据库 PostgreSQL + Drizzle ORM
认证 Better Auth + Google OAuth + Magic Link
样式 Tailwind CSS 4 + shadcn/ui
支付 Creem + Stripe
存储 R2/S3
动画 Framer Motion

📝 环境变量

# 数据库
DATABASE_URL='postgresql://user:pass@host:5432/db'

# 认证
BETTER_AUTH_SECRET='your-secret'
NEXT_PUBLIC_APP_URL='http://localhost:3000'
GOOGLE_CLIENT_ID='your-google-client-id'
GOOGLE_CLIENT_SECRET='your-google-client-secret'

# 存储 (R2/S3)
STORAGE_ENDPOINT='https://your-r2-endpoint'
STORAGE_ACCESS_KEY='your-access-key'
STORAGE_SECRET_KEY='your-secret-key'
STORAGE_BUCKET='your-bucket'
STORAGE_DOMAIN='https://your-domain.com'

# AI 提供商
EVOLINK_API_KEY='your-evolink-key'
KIE_API_KEY='your-kie-key'
AI_CALLBACK_URL='https://your-domain.com/api/v1/video/callback'
AI_CALLBACK_SECRET='your-callback-secret'

# 支付 - Creem (主要)
CREEM_API_KEY='your-creem-key'
CREEM_WEBHOOK_SECRET='your-creem-webhook-secret'

# 支付 - Stripe (备用)
STRIPE_API_KEY='your-stripe-key'
STRIPE_WEBHOOK_SECRET='your-stripe-webhook-secret'

# 邮件
RESEND_FROM='noreply@yourdomain.com'

🔄 同步模板更新

如果你基于本模板创建了自己的项目,可以按照以下方式同步模板的最新更新:

方式一:添加上游仓库(推荐)

# 添加上游仓库
git remote add upstream https://github.com/zifeixu85/videofly-template.git

# 获取上游更新
git fetch upstream

# 合并上游 main 分支
git merge upstream/main --allow-unrelated-histories

# 解决冲突后,推送到你自己的仓库
git push origin main

方式二:手动比较更新

# 添加上游仓库
git remote add upstream https://github.com/zifeixu85/videofly-template.git

# 查看上游变更
git diff upstream/main...main

# 选择性合并(查看变更后手动复制)
git checkout upstream/main -- src/components/landing

同步注意事项

  1. 备份数据 - 同步前备份你的 .env.local 和数据库
  2. 处理冲突 - 如果有冲突,需要手动解决
  3. 环境变量 - 模板更新可能新增环境变量,检查 .env.example
  4. 数据库迁移 - 如有 schema 变更,执行 pnpm db:migrate

🧩 近期更新(2026-01-26)

  • 模型与参数映射统一:所有 provider 参数转换集中在 src/ai/model-mapping.ts,Veo 3.1 高/低质量自动选择对应模型 ID
  • 生成参数对齐:首页与工具页统一支持 mode / imageUrl(s) / outputNumber / generateAudio,图片上传走 /api/v1/upload
  • 模型能力修正:Veo 3.1 固定 8s;Wan 2.6 / Seedance 分辨率与质量映射统一
  • 状态与通知:SSE + 15s 轮询,生成完成支持浏览器通知与 toast
  • My Creations 体验优化:4:3 卡片、hover 自动播放、错误信息展示在预览区

2026-02-02

  • 定价组件升级:默认展示 Monthly,Yearly 20% OFF 标签,高亮 Popular 方案 UI
  • 权限与修复:CreditHistory 崩溃修复,针对免费用户的购买限制逻辑(仅 Subscribers 可买特定包)

🗺 路线图

  • 多 AI 模型支持
  • 积分系统
  • 支付集成 (Creem + Stripe)
  • 用户认证
  • 视频历史记录
  • 多语言国际化
  • 团队协作功能
  • API 访问
  • Webhooks 导出

📄 许可证

本项目基于 MIT 许可证开源。

🙏 致谢

本项目基于以下优秀开源项目:

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors