
StoryGen-Atelier
输入故事创意,自动生成分镜、过渡片段并拼成视频
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-09-29 · 当前星标 ★ 1015
使用教程
ℹ 本教程由 AI 依据该项目 README 整理,个别步骤可能需要按你的环境微调。
环境要求
- Node.js 与 npm(前端与后端均为 JavaScript 项目)
- Google Cloud 账号,并开通 Gemini 与 Vertex AI Veo 的调用权限
- 本地可执行的 ffmpeg,用于拼接最终视频
- 后端 .env 中需填入真实的 API 密钥与项目信息
安装与启动步骤
-
1获取项目代码
把仓库克隆到本地并进入项目根目录,后续前后端都在此仓库内操作。
git clone https://github.com/0xsline/StoryGen-Atelier.git cd StoryGen-Atelier -
2安装后端依赖
进入 backend 目录安装 Node 依赖,注意 Node 版本不要过低。
cd backend npm install -
3生成并填写配置
复制配置模板为 .env,按模板中的键名填入真实的密钥与云端项目信息。
cp .env.example .env -
4启动后端服务
在 backend 目录启动开发服务;也可用 npm start 以普通方式启动。
npm run dev -
5安装前端依赖
另开一个终端,进入 frontend 目录安装前端依赖。
cd frontend npm install -
6启动前端界面
启动前端开发服务器,默认监听 5180 端口,浏览器访问该端口使用。
npm run dev -
7构建前端产物
需要静态部署时在 frontend 目录执行构建,生成可发布的前端文件。
cd frontend && npm run build
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
backend/.env | 是 | 后端运行所需的密钥与云端配置,按 .env.example 中的键名逐项填写。 | 参见 backend/.env.example 的键名填写真实值 |
如何确认成功
后端启动无报错,浏览器打开 http://localhost:5180 能看到前端界面并可发起分镜生成。
常见问题
Q:可以只启动一个服务吗?
A:README 的 Quick Start 提到可在根目录一键启动,但该段命令在节选中缺失,请以仓库 README 原文为准,否则需按手动方式分别启动前后端。
Q:前端为什么打不开?
A:前端默认端口为 5180,确认服务已启动且端口未被占用;后端未启动时页面可打开但生成功能不可用。
Q:视频拼接失败怎么办?
A:最终视频由 ffmpeg 拼接,请确认系统中 ffmpeg 已安装并可在命令行直接调用。
Q:密钥从哪里获取?
A:需要 Google Cloud 的 Gemini 与 Vertex AI(Veo)服务凭证,在对应云控制台开通并创建后填入 .env。
注意事项
- README 中 Quick Start 的命令块在节选里为空,一键启动命令请以仓库 README 原文为准,不要自行猜测。
- 后端 npm run dev 与 npm start 二选一即可,前者用于开发调试。
- 日志与画廊数据通过 SQLite 本地持久化,迁移或备份时注意相关数据文件。
- 生成过程会调用云端模型,注意账户配额与调用费用。
核心亮点
- 端到端串联 Gemini 分镜、Veo 过渡片段与 ffmpeg 拼接,省去手动拼装多个 API 的步骤
- 内置日志和画廊管理,生成过程可追溯,方便对比不同分镜和帧的效果
- 基于 JavaScript 和常见云服务,代码结构相对容易理解和二次修改
不足之处
- 强依赖 Google Cloud 的 Gemini 和 Vertex AI Veo,需要账号、额度和区域配置,门槛和成本不低
- 项目处于早期,星标约 986,文档和社区案例可能还不够丰富
适用场景
- 把短篇故事创意快速转成带过渡动画的短视频草稿
- 为广告或产品概念制作 AI 分镜和动态预览
- 教学或演示中展示从文本到视频的完整 AI 生成流程
替代项目
ComfyUI、ShortGPT
上一篇:ComfyUI-MiniMax-H3-Promptor
下一篇:millivid
同类项目推荐
EffectErase
开源
一键擦除视频物体,还能无缝插入新内容
[CVPR 2026 Highlight] EffectErase: Joint Video Object Removal and Insertion for High···
OnlyShot
开源
一句话生成完整短剧,五步直达红果抖音
OnlyShot · 神仙鱼 AI 短剧工业流水线 Claude Skill — 一句话 → 剧本/分镜/分镜图/视频···
svor
开源
用扩散模型一键抹掉视频里的物体,背景自动补全
SVOR - Stable Video Object Removal
FireRed-OpenStoryline
开源
动嘴说想法,AI 帮你剪出专业视频
FireRed-OpenStoryline is an AI video editing agent that transforms manual editing in···
OpenMontage
开源
素材丢进去,智能体流水线自动剪片,成片自己出来
World's first open-source, agentic video production system. 12 production pipelines,···
MACE-Dance
开源
给一段音乐,自动生成节奏对得上的舞蹈视频
[SIGGRAPH 2026] MACE-Dance: Motion-Appearance Cascaded Experts for Music-Driven Danc···
otopilot
开源
给个主题,本地自动产出带配音字幕的成片
Turn a topic into a finished YouTube Short/video: script, free & CC0 images, voice-o···
Awesome-Controllable-Video-Diffu···
开源
一站式掌握可控视频生成前沿资源
Awesome Controllable Video Generation with Diffusion Models
NWT-pytorch
开源
用音频驱动生成同步视频,快速上手跨模态生成
Implementation of NWT, audio-to-video generation, in Pytorch