InspoVanna：开源本地AI短剧工作站，剧本分镜图文视频一站式全链路创作工具

一、InspoVanna是什么

InspoVanna 前身为 DreamHub，是一款开源、本地部署的一站式AI短剧创作工作站，项目深度接入火山方舟Seedance 2.0视频大模型，打通剧本构思→AI分镜可视化→图像生成→视频制作→视频超清修复完整短剧创作链路，所有剧本、角色、图像、视频、音频素材全部存储在本地设备，不会自动上传第三方服务器，兼顾创作隐私与数据安全。

工具面向短剧编剧、短视频创作者、AIGC个人工作室、影视分镜设计师，支持Windows、macOS、Linux全平台一键部署，内置可视化分镜画布、多模态对话、素材资产管理全套功能，无需切换多款软件即可独立完成短剧全流程制作，配套AI Maker Hub创意交流社区供创作者交流素材与制作经验。

二、核心功能特色

（一）多模态AI对话助手

1. 底层搭载Doubao Seed 2.0 Pro/Lite模型，支持图文、视频、多格式文档上传交互；

2. 可解析JPG/PNG/MP4/PDF/Word/PPT/TXT等数十种文件，用于剧本润色、剧情分析、提示词优化；

3. 消息支持复制、一键保存至本地工作空间，对话上下文留存20轮，创作连续性强。

（二）AI图像生成模块

提供三种生成模式，适配分镜角色、场景原画创作：

• 支持Seedream 4.0/4.5/5.0 Lite图像模型，最高输出4K分辨率，覆盖1:1、9:16、16:9等全主流短视频比例；

• 自定义批量生成1-4张组图，Seedream 5.0 Lite自带联网搜索能力，丰富画面细节。

（三）视频生成与智能超清修复

1. 视频生成
   依托Seedance 2.0/Seedance 2.0 Fast视频模型，支持文字、参考图、参考视频、参考音频四维度素材驱动；视频时长4-15秒，分辨率可选480p/720p/1080p，自带音画同步生成，任务后台异步运行，底部状态栏实时展示进度。

2. AI智能超清
   集成AI MediaKit接口，分标准版、专业版，适配短剧、老片修复、UGC短视频、通用画面增强，可将素材提升至2K/4K高清分辨率，修复模糊、抖动画面。

（四）核心特色：StoryBoard可视化分镜工作台

项目差异化核心功能，分层式短剧创作架构：项目→剧集→场景→分镜画布

1. 剧本智能拆分：粘贴或上传剧本文件，AI自动分级拆解剧集、场景、镜头，自动生成对应提示词；

2. 拖拽式节点画布：基于Vue Flow开发，包含提示词、图像、视频、音频四类节点，连线代表素材引用关系，一键自动排版画布；

3. 素材库@引用机制：统一管理角色、道具、场景设定，节点提示词输入@角色名可自动带入角色描述与参考图，保证全片人物统一；

4. 全局AI创作助手：悬浮对话窗口，识别当前创作层级（剧集/场景/镜头），针对性优化剧本、分镜、镜头提示词；

5. 本地工程自动归档：分镜工程文件、素材自动同步至工作空间，完整留存项目结构，可随时二次编辑。

（五）本地工作空间全素材管理

1. 按项目隔离存储，每个项目自动划分Text、Image、Video、Audio四类文件夹；

2. 支持项目新建、切换、删除，文件拖拽移动、重命名、本地上传、在线预览；

3. 视频素材支持提取首尾帧图片，直接复用至分镜图像节点。

（六）安全与轻量化特色

1. 密钥配置文件config.json加入.gitignore，避免API密钥泄露；

2. 全部创作数据本地存储，无强制云端上传行为；

3. API密钥仅程序运行时加载至内存，无持久明文留存风险；

4. 轻量化Python后端，无重型Web框架，低配设备也可部署运行。

三、技术细节

1. 前后端架构

• 后端：Python原生http.server，单文件轻量化服务，无第三方Web框架依赖，启动端口默认8765；

• 前端：原生JavaScript+Tailwind CSS，资源通过CDN加载；StoryBoard分镜画布基于Vue3+Vue Flow CDN实现；

• 第三方依赖：tos（火山引擎对象存储）、opencv-python（视频帧提取）、Pillow（图像处理）。

2. 自动化测试与工程规范

仓库配置GitHub Actions流水线，代码提交/PR自动执行ruff代码规范检测、pytest单元测试，统一代码格式；配套requirements.txt、requirements-dev.txt区分生产、开发依赖，锁定版本避免环境冲突。

3. 部署适配逻辑

• Windows：双击run.bat自动创建虚拟环境、安装依赖，自动启动浏览器访问本地服务；

• macOS/Linux：执行run.sh脚本，自动检测Python，缺失则通过Homebrew/apt安装运行环境；

• 手动启动方案：pip install -r requirements.txt && python src/server.py。

4. 依赖API接口（火山引擎系列）

程序运行前需配置三类密钥，存储于config.json或前端设置页面：

1. 火山方舟API Key：驱动文生、图生、视频大模型；

2. TOS AK/SK：本地参考素材文件上传存储；

3. AI MediaKit API：视频智能超清增强。

四、应用场景

1. 短剧个人创作者：单人完成爽文短剧、都市情感、古风漫剧全流程制作，一套工具替代剧本软件、绘图工具、视频生成器；

2. 短视频工作室：批量产出剧情类短视频，StoryBoard分镜统一管理镜头，角色库保证系列短剧人物形象统一；

3. 影视分镜设计师：快速生成可视化数字分镜，AI辅助镜头设计，输出图像、视频镜头素材对接后期剪辑；

4. AIGC教学/创意社区：本地开源无商用额度限制，适合教学演示、自制创意短片、剧情类营销短视频；

5. 内容创业者：本地存储素材，规避云端平台素材丢失、版权限流问题，低成本批量生产剧情内容。

五、完整使用方法

步骤1：获取项目源码

两种渠道任选其一：

1. Git克隆（推荐）

git clone https://github.com/zzdrill/InspoVanna.git
cd InspoVanna

2. 手动下载：仓库页面点击绿色Code按钮→Download ZIP，解压后进入项目根目录。

步骤2：一键启动本地服务

1. Windows系统：直接双击run.bat，首次运行自动搭建虚拟环境、安装全部依赖，完成后自动打开浏览器访问http://localhost:8765；

2. macOS/Linux系统：终端执行chmod +x run.sh，再执行./run.sh，程序自动补全Python运行环境并启动服务；

3. 手动启动备选：终端执行pip install -r requirements.txt && python src/server.py。

步骤3：配置火山引擎API密钥

两种配置方式：

1. 前端可视化配置：打开网页后进入设置页面，填写火山方舟API Key、TOS AK/SK、AI MediaKit密钥；

2. 文件配置：编辑项目根目录config.json.example，填入密钥后重命名为config.json。

步骤4：设置本地工作空间

在设置页面选择本地文件夹作为全局工作空间，所有生成图文视频自动按项目分类保存，自动生成Text/Image/Video/Audio子目录。

步骤5：短剧全流程创作

1. 文本对话：AI辅助撰写、润色短剧剧本；

2. StoryBoard分镜制作：导入剧本自动拆分剧集/场景/镜头，拖拽图像、视频节点，@素材库角色生成镜头素材；

3. 图像生成：为分镜镜头生成角色、场景原画；

4. 视频生成：基于分镜提示词、参考图生成剧情短视频；

5. 超清优化：对成片视频执行AI超清修复提升画质；

6. 素材管理：在工作空间统一浏览、导出、复用所有镜头素材。

六、竞品对比

选取即梦AI、Storyboarder、花火Studio三款同赛道工具横向对比：

七、常见问题解答（FAQ）

Q：页面顶部提示“未配置”，无法使用生成功能怎么办？

A：进入网页端设置页面，核对火山方舟API Key、TOS AK/SK、AI MediaKit三组密钥是否完整填写，若文件配置则检查config.json参数格式是否正确。

Q：提交视频生成任务后持续失败，无法产出视频？

A：首先确认火山方舟API Key有效，并且在火山方舟控制台创建了Seedance视频模型对应的接入点；其次检查提示词无违规内容，参考素材数量不超过上限。

Q：上传参考图片提示上传失败是什么原因？

A：排查TOS对象存储AK、SK密钥是否填写正确，同时确认火山引擎后台已创建可用的TOS存储Bucket，网络正常可访问火山存储接口。

Q：打开StoryBoard分镜页面空白、界面加载失败？

A：StoryBoard前端资源依赖esm.sh、jsdelivr.net CDN，需要保证本地网络能够正常访问这两个域名，网络受限会导致画布组件加载不全。

Q：启动程序提示端口8765被占用，无法打开网页？

A：Windows打开任务管理器，结束占用8765端口的进程；macOS/Linux终端执行lsof -i :8765查询进程PID并kill；也可修改src/server.py内端口号更换端口运行。

Q：如何新增、更换项目内置AI大模型？

A：打开项目根目录config.json，在models字段内添加新模型名称与火山方舟接入点ID，保存后重启服务即可加载新模型。

Q：本地重装系统后，如何找回之前创作的短剧项目？

A：项目素材全部保存在自定义的本地工作空间文件夹，只需重新部署InspoVanna，在设置页选择原有工作空间目录，即可读取全部剧集、分镜、素材数据。

八、相关链接

• GitHub仓库地址：https://github.com/zzdrill/InspoVanna

九、总结

InspoVanna是一款兼顾开源免费、本地隐私、全链路短剧创作的轻量化AI工具，依托火山方舟Seedance、Seedream系列大模型，整合AI剧本创作、可视化节点分镜、图文视频生成、视频超清修复、本地素材资产管理五大核心能力，区别于云端在线短剧工具的数据上传限制与闭源分镜软件的功能割裂问题，支持全平台一键部署，个人创作者、小型工作室均可低成本搭建本地短剧流水线，完整覆盖从创意剧本到高清成片的全部创作需求，同时开源特性允许开发者自由修改、拓展程序功能，适配个性化短剧生产需求。