Thanks to visit codestin.com
Credit goes to github.com

Skip to content

EnvX-Agent/firework-web

Repository files navigation

🎆 烟花视频生成器

一个基于 Google AI (Nano Banana + Veo 3.1) 的烟花视频生成工具。上传一张照片,AI 会自动将背景替换为烟花场景,并生成动态烟花视频。

✨ 功能特点

  • 📸 智能背景替换:使用 Nano Banana (gemini-2.5-flash-image) 将照片背景替换为烟花场景
  • 🎬 视频生成:使用 Veo 3.1 根据烟花图片生成动态烟花视频
  • 🚀 简单易用:只需上传照片,无需输入提示词,AI 自动处理
  • 💾 下载功能:支持下载生成的烟花图片和视频

🛠️ 技术栈

  • 运行时:Bun
  • 前端框架:React 19
  • UI 组件:Tailwind CSS + shadcn/ui
  • AI 模型
    • Nano Banana (gemini-2.5-flash-image) - 图像生成
    • Veo 3.1 - 视频生成
  • API:Google GenAI SDK

📦 安装

bun install

🔑 配置

在项目根目录创建 .env 文件,添加你的 Google API Key:

GOOGLE_API_KEY=your_google_api_key_here

🚀 运行

开发环境:

bun dev

生产环境:

bun start

服务器将在 http://0.0.0.0:3101 启动。

📖 使用方法

  1. 打开浏览器访问 http://localhost:3101
  2. 点击上传区域或拖拽一张照片
  3. 点击"生成烟花视频"按钮
  4. 等待 1-3 分钟(AI 处理需要时间)
  5. 下载生成的烟花图片和视频

🎯 工作流程

用户上传照片
    ↓
步骤 1: Nano Banana 生成烟花背景图片
    ↓
步骤 2: Veo 3.1 生成烟花动画视频
    ↓
用户下载结果

📝 API 端点

  • POST /api/generate - 生成烟花图片和视频

    • 请求体:{ images: string[] } (base64 编码的图片)
    • 响应:{ success: boolean, image: string, video: VideoInfo, text: string }
  • POST /api/download-video - 下载生成的视频

    • 请求体:{ videoName: string }
    • 响应:视频文件 (video/mp4)

⚠️ 注意事项

  • 视频生成需要 1-3 分钟,请耐心等待
  • 确保有稳定的网络连接
  • 需要有效的 Google API Key 并启用相关 API
  • 建议上传清晰的照片以获得更好的效果

📄 许可证

MIT


This project was created using Bun. Bun is a fast all-in-one JavaScript runtime.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published