AI 视频入门套件

一个用于构建 AI 驱动视频应用的强大入门套件。基于 Next.js、Remotion 和 fal.ai 构建，该工具包简化了在浏览器中使用 AI 视频模型的复杂性。

特性

• 🎬 原生浏览器视频处理：在浏览器中无缝处理和合成视频
• 🤖 AI 模型集成：通过 fal.ai 直接访问最先进的视频模型
  • Minimax 用于视频生成
  • Hunyuan 用于视觉合成
  • LTX 用于视频编辑
• 🎵 高级媒体功能：
  • 多片段视频合成
  • 音频轨道集成
  • 配音支持
  • 更长视频时长处理
• 🛠️ 开发者工具：
  • 元数据编码
  • 视频处理流水线
  • 开箱即用的 UI 组件
  • TypeScript 支持

技术栈

• fal.ai - AI 模型基础设施
• Next.js - React 框架
• Remotion - 视频处理
• IndexedDB - 浏览器端存储（无需云数据库）
• Vercel - 部署平台
• UploadThing - 文件上传

快速开始

1. 克隆仓库：

git clone https://github.com/fal-ai-community/video-starter-kit
cd video-starter-kit

2. 安装依赖：

npm install
# 或者
yarn install
# 或者
pnpm install

3. 设置环境变量：

cp .env.example .env.local

4. 启动开发服务器：

npm run dev
# 或者
yarn dev
# 或者
pnpm dev

打开 http://localhost:3000 即可查看应用。

贡献

我们欢迎贡献！更多信息请参阅我们的 贡献指南。

社区

• Discord - 加入我们的社区
• GitHub 讨论区 - 用于提问和讨论
• Twitter - 关注我们获取最新动态

许可证

本项目采用 MIT 许可证授权——详情请参阅 LICENSE 文件。

部署

部署应用最简单的方式是通过 Vercel。

video-starter-kit 快速上手指南

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• Node.js: 建议安装 LTS 版本（v18 或更高）。
• 包管理器: npm、yarn 或 pnpm 任一即可。
• 账号准备: 需要 fal.ai 账号以获取 API Key（用于调用 AI 视频模型）。
• 浏览器: 推荐使用最新版的 Chrome 或 Edge，以获得最佳的浏览器端视频处理体验。

安装步骤

1. 克隆项目仓库

git clone https://github.com/fal-ai-community/video-starter-kit
cd video-starter-kit

2. 安装依赖

您可以使用国内镜像源加速安装（以 npm 为例）：

npm install --registry=https://registry.npmmirror.com
# 或使用 yarn / pnpm
# yarn install
# pnpm install

3. 配置环境变量

复制示例配置文件并填入您的 fal.ai API Key：

cp .env.example .env.local

编辑 .env.local 文件，填入关键信息：

FAL_KEY=your_fal_ai_api_key_here

4. 启动开发服务器

npm run dev
# 或
# yarn dev
# pnpm dev

启动成功后，访问 http://localhost:3000 即可看到应用界面。

基本使用

该工具包旨在简化浏览器端的 AI 视频生成与编辑流程。

1. 访问界面：打开浏览器进入本地服务地址。
2. 选择模型：在界面中选择支持的 AI 模型（如 Minimax 用于生成、Hunyuan 用于视觉合成、LTX 用于视频操控）。
3. 输入提示词/上传素材：
   • 对于生成任务，输入文本提示词（Prompt）。
   • 对于编辑任务，上传本地视频片段或音频文件。
4. 执行处理：点击生成按钮，系统将调用 fal.ai 接口并在浏览器中利用 Remotion 进行视频渲染与合成。
5. 预览与导出：处理完成后，可直接在浏览器中预览结果，支持多片段组合、音轨混合及长视频处理，并可下载最终视频文件。

提示：项目基于 Next.js 和 Remotion 构建，所有视频处理逻辑均在浏览器端或通过 Serverless 函数调用 AI 模型完成，无需配置复杂的本地 GPU 环境。