OpenStory：开源AI视频生成平台，脚本驱动自动完成镜头拆分与成片合成

OpenStory是什么

OpenStory（曾用名Velro）是一款基于MIT开源协议、使用TypeScript开发的AI视频生成Web应用。核心逻辑是输入文字脚本，系统自动完成镜头拆解、画面生成、音频制作、视频剪辑合成，输出完整AI短视频作品。项目整套架构面向边缘云环境设计，原生适配Cloudflare生态，支持本地部署与云端托管，兼顾个人创作者与小型团队协作需求，无需专业剪辑软件，依靠大模型与多模态AI能力完成视频全链路生产。

功能特色

1. 脚本智能解析分镜：粘贴文本脚本，AI自动拆解场景与镜头，输出镜头角度、画面氛围、人物动作等镜头参数，维护镜头之间画面叙事连续性，不用手动逐个设置镜头。

2. 多模态AI素材自动生成：对接Fal.ai完成图片、图生视频生成，配套音频生成能力，自动产出镜头画面、配音素材。

3. 全局风格一致性控制：统一管控角色形象、场景布景、色调灯光，跨多个镜头保持视觉风格统一，避免AI生成画面人物、场景画风跳变。

4. 无密码身份登录：集成Better‑Auth，支持Passkey密钥登录，简化账号注册登录流程。

5. 团队协作预留能力：内置待上线团队工作空间模块，未来可实现角色库、风格模板、音频特效素材团队共享。

6. 边缘流式任务处理：基于Cloudflare工作流做持久任务，生成进度实时SSE推送，长视频生成不会因为页面关闭中断任务。

技术细节

• 运行环境：Bun ≥1.3.0，本地开发使用Workerd模拟Cloudflare资源，无需Docker。

• 前端框架：TanStack Start + TanStack Router + Vite，UI组件采用Tailwind v4 + shadcn/ui。

• 数据库层：Drizzle ORM，底层存储为Cloudflare D1(SQLite)。

• AI服务对接：TanStack AI封装调用层；Fal.ai负责图像、视频生成；OpenRouter提供脚本解析大模型能力；PostHog用于埋点与可观测监控。

• 云基础设施：Cloudflare Workers、Workflows、Durable Objects、R2对象存储，全部为边缘部署架构。

• 工程质量工具：oxlint、oxfmt、Knip、Lefthook；测试套件包含Vitest单元测试、Playwright端到端E2E测试。

• 版本发布：CI/CD流水线，main分支自动部署，PR自动生成预览环境，自动创建独立D1测试数据库。

应用场景

1. 短剧创作者：输入剧本脚本，快速批量生成AI短剧分镜成片，降低AI短剧制作门槛。

2. 短视频内容博主：故事类、科普类短视频，文字脚本直接转视频，快速产出内容草稿。

3. 内容团队小协作：团队成员共享角色模板、画面风格，统一产出系列化AI视频内容。

4. 演示原型制作：文案故事快速生成视频样片，用于创意提案、方案演示。

5. 二次开发定制：开发者可二次改造，搭建私有化AI视频生成服务，集成自有业务系统。

使用方法

本地开发部署

1. 克隆项目仓库

git clone https://github.com/openstory-so/openstory.git
cd openstory

2. 安装依赖

bun install

3. 初始化配置，交互式填入密钥 FAL_KEY、OPENROUTER_KEY

bun setup

4. 启动本地开发服务

bun dev

访问 http://localhost:3000 即可打开Web界面，本地环境会自动执行数据库迁移。

云端部署

1. 拥有Cloudflare账号，使用项目内置部署按钮一键创建D1、R2、Workers资源。

2. 执行生产环境配置：bun setup --prod。

3. 执行部署命令 bun cf:deploy:prd；推送代码到main分支，CI会自动完成云端发布。

提示：AI图像视频生成必须配置Fal密钥，脚本解析依赖OpenRouter密钥，缺少密钥无法生成视频素材。

竞品对比

常见问题解答

本地启动bun dev报错，依赖安装失败怎么办？

确认Bun版本≥1.3.0，删除node_modules文件夹重新执行bun install；Windows环境建议使用WSL2环境运行，原生Windows环境兼容性较差。

页面可以打开，但是无法生成视频画面？

检查.env配置文件，确认FAL_KEY、OPENROUTER_KEY密钥正确填写，密钥拥有对应接口调用额度；密钥错误或者余额耗尽，会直接导致素材生成失败。

是否可以脱离Cloudflare平台部署到其他服务器？

项目原生大量依赖Cloudflare D1、Durable Objects、R2对象存储，直接迁移到普通服务器改动量很大，需要替换全部存储与工作流组件，官方优先支持Cloudflare生态。

可以接入自己本地部署的大模型吗？

底层调用层封装在TanStack AI，理论上可修改代码替换OpenRouter为自定义模型API，需要自行修改源码适配，官方没有提供可视化切换配置。

生成任务页面关闭之后任务会中断吗？

云端部署使用Cloudflare Workflows持久任务，页面关闭依旧后台执行；本地开发环境页面关闭任务会终止。

相关链接

• GitHub仓库：https://github.com/openstory-so/openstory

总结

OpenStory是一套完整开源的AI视频生成Web应用，把脚本解析、镜头拆分、多模态素材生成、视频合成整套流程整合在一起，依托Cloudflare边缘基础设施实现部署运行，适合个人创作者快速制作AI故事视频，也可供开发者二次开发，项目全部代码公开，遵循MIT开源协议，降低AI视频成片工具的自建门槛。