waoo

在 AI 生成视频领域，保持角色一致性、构建连贯分镜以及实现全流程可控，一直是困扰创作者的三大难题。waoowaoo AI 影视 Studio 试图通过引入“工业级全流程可控协作式 AI Agent”架构，将好莱坞专业制片团队的思路转化为可落地的软件工具。

这是一个支持本地部署的开源平台，旨在让用户拥有自己的“虚拟制片场”。无论是短篇故事、动态漫剧，还是接近真人质感的影视剧，用户只需输入小说文本，系统即可自动完成从剧本解析、角色场景生成、分镜绘制到最终视频合成的全过程。

核心功能：重构影视生产工作流

waoowaoo 不仅仅是一个简单的文生视频工具，它模拟了真实的影视制作管线，通过多个 AI Agent 协作完成任务：

1. 智能剧本分析 (AI Script Analysis)

系统内置专业的剧本解析引擎，能够自动阅读小说或剧本文本，精准提取：

• 角色档案：自动归纳人物外貌、性格及关系。
• 场景描述：识别时间、地点及环境氛围。
• 剧情结构：拆解关键情节点，为分镜制作提供逻辑基础。

2. 一致性角色与场景生成 (Consistent Character & Scene)

针对 AI 视频常见的“角色脸盲”问题，waoowaoo 采用了专门的模型微调与参考机制：

• 角色锁定：确保同一角色在不同镜头、不同时间段的外貌特征高度一致。
• 场景复用：根据剧本描述生成标准化场景资产，支持多角度调用。

3. 自动化分镜与视频合成 (Storyboard to Video)

• 智能分镜：根据剧情自动规划镜头语言（景别、运镜），生成分镜图。
• 视频合成：将静态分镜转化为动态视频，自动处理转场与节奏。

4. 多角色 AI 配音 (AI Dubbing)

内置多角色语音合成引擎，能够根据对话上下文自动分配音色，支持情感调节，实现音画同步。

5. 全球化支持

• 界面支持中文/英文一键切换。
• 适配多语言剧本输入，打破语言创作壁垒。

极速部署：三分钟搭建本地制片场

waoowaoo 采用容器化架构，依赖 Docker 运行，确保了环境的一致性与安装的便捷性。无需配置复杂的 Python 环境或依赖库，仅需三条命令即可启动。

前置要求

• 已安装 Docker Desktop (Windows/macOS) 或 Docker Engine + Docker Compose (Linux)。

安装步骤

1. 克隆项目

git clone https://github.com/saturndec/waoowaoo.git
cd waoowaoo

2. 启动服务

docker compose up -d

系统将在首次启动时自动完成数据库初始化，无需人工干预。

3. 访问界面
打开浏览器访问：http://localhost:13000

⚠️ 性能优化：启用 HTTPS

如果在 HTTP 模式下遇到网页卡顿或并发连接受限（浏览器对非 HTTPS 站点的并发限制），建议通过 Caddy 启用 HTTPS 以获得最佳体验：

# 安装并运行 Caddy (需提前安装 caddy 二进制文件)
caddy run --config Caddyfile

启动后访问：https://localhost:1443

更新维护

获取最新版本非常简单：

git pull
docker compose down && docker compose up -d --build

API 配置与模型推荐

启动完成后，进入系统“设置中心”配置所需的 AI 服务 API Key。平台内置了详细的配置教程。

为了获得最佳的生成效果与成本平衡，官方推荐以下模型组合：

• 视频/图像生成：
  • 字节跳动火山引擎：推荐使用 Seedance (视频) 和 Seedream (图像) 模型，其在中文语境理解和长视频一致性上表现优异。
  • 谷歌 AI Studio：推荐测试 Banana 系列模型。
• 文本大模型：
  • OpenRouter API：当前剧本分析与分镜规划环节必须配置 OpenRouter，以支持灵活的路由和多模型调用。