ArcReel：开源AI多智能体视频工作台，小说全自动生成短剧分镜与成片

一、ArcReel是什么

ArcReel 是一款基于 AGPL-3.0 开源协议、AI Agent 多智能体驱动的小说转短视频全链路可视化工作台，项目当前稳定版本 0.7.1，基于 Python 3.12 + FastAPI + React 19 搭建，支持私有化 Docker 部署，无需依赖第三方云端平台存储素材与项目数据。

项目核心定位：一站式完成网文小说→分镜剧本→角色原画→分镜插画→动态视频→成片合成全自动化流水线，同时支持导出剪映草稿二次剪辑，面向自媒体、短剧工作室、AI内容创作者提供本地可部署、多模型兼容、角色画面统一的工业化AI视频生产工具。

底层依托 Claude Agent SDK 构建多智能体调度系统，统一封装图像、视频、文本三大生成后端抽象层，原生兼容 OpenAI、Gemini、火山方舟、Grok 四大主流大模型厂商，同时支持 Ollama、vLLM 等任意 OpenAI/Google 兼容自定义模型接口，全局/项目双层级灵活切换模型供应商。

二、功能特色

（一）全链路自动化小说转视频流水线

完整标准化创作流程：上传小说文本 → AI Agent 自动拆分剧集、生成分镜剧本 → 生成统一角色设计图、关键道具线索图 → 批量生成标准化分镜图 → 调用视频模型生成片段 → FFmpeg 自动合成完整成片；内置两种创作模式：

1. 说书模式（narration）：以朗读旁白节奏拆分镜头，适配网文解说短视频；

2. 剧集动画模式（drama）：基于对话、场景划分镜头，适配短剧、动态漫。

长篇小说支持人机协作分集规划：AI 自动探测剧情断点、用户确认后物理切分剧集，支持分段分批生成。

（二）多智能体AI Agent 调度架构

采用「主Agent + 编排Skill + 聚焦子Subagent」分层架构，分工完成角色提取、剧本标准化、分镜生成、素材渲染等任务：

1. 编排Skill自动检测项目进度，从任意阶段断点续跑；

2. 各子Agent独立完成单一任务，仅向主Agent返回精简摘要，节省大模型上下文窗口；

3. 每阶段生成结果人工确认后再进入下一流程，可控性强；

4. 支持 OpenClaw 外部Agent平台对接，通过自然语言远程创建项目、生成视频。

（三）多模态多厂商统一模型接入

搭建 ImageBackend/VideoBackend/TextBackend 三层抽象接口，统一管理文生图、文生视频、文本剧本生成，支持全局、项目独立两套配置，项目设置优先级高于全局默认：

1. 图片生成：支持文生图、多参考图图生图，火山方舟 Seedream、OpenAI GPT Image、Gemini Nano Banana、Grok Imagine 全覆盖；

2. 视频生成：支持图生视频、视频时长延展、负面提示词、种子参数控制，兼容 Sora 2、Veo 3.1、Seedance、Grok Imagine Video；火山方舟模型额外内置音频生成能力；

3. 文本大模型：四大厂商文本模型统一接入，强制结构化输出，适配剧本、分镜JSON生成；

4. 自定义供应商兼容：填入第三方API地址与密钥自动拉取模型列表，本地Ollama、中转API均可接入，享有与官方模型完全一致功能。

（四）画面视觉一致性核心能力

解决AI批量生成画面人物、道具、场景崩坏问题：

1. 角色统一图纸：先生成完整角色设定图，所有分镜、视频强制参考角色特征；

2. 线索追踪系统：标记关键道具、场景元素，跨镜头保持外观、尺寸、色彩统一；

3. 全局风格参考图：上传插画/影视风格图，全局统一渲染画风；

4. 版本历史回滚：每次重新生成自动存档，单镜头、整套剧集均可一键恢复历史版本。

（五）任务调度与费用管控体系

1. 异步任务队列，图文媒体独立并发通道，RPM速率限流、lease机制调度，支持长时间任务断点续传；

2. 全链路费用统计：图片、视频、文本Token消耗分厂商、分币种独立核算；

3. 三级费用预估：项目总预算、单集成本、单镜头生成费用，生成前提前展示预估与实际消耗对比。

（六）配套生产辅助功能

1. React可视化Web工作台：项目管理、素材实时预览、SSE流式任务进度推送、内置对话AI助手；

2. 导出剪映草稿ZIP包，兼容剪映5.x/6.0以上版本，支持本地二次剪辑；

3. 项目导入/导出打包，一键备份、跨设备迁移；

4. 双重权限认证：后台账号JWT登录、OpenClaw对接API Key鉴权；

5. 完整数据库迁移工具Alembic，支持本地SQLite、生产PostgreSQL双数据库。

三、技术细节

3.1 四层分层技术架构

前端WebUI（React19）→ FastAPI服务层 → 核心业务库 → 数据持久层

1. 前端层：React 19 + TypeScript + Tailwind CSS 4，使用zustand状态管理、Framer Motion动画、wouter路由，Vite打包；提供项目管理、素材预览、AI对话、任务监控四大模块。

2. 服务层：Python FastAPI异步服务，承载REST接口、Claude Agent Runtime、SSE实时任务推送、JWT/API Key鉴权逻辑。

3. 核心库层：统一图文视频后端抽象层、任务并发队列、项目版本管理器、费用追踪模块；集成FFmpeg媒体合成、Pillow图像处理。

4. 数据层：SQLAlchemy 2.0 异步ORM，默认SQLite轻量化部署，生产环境切换PostgreSQL；Alembic管理数据库版本迁移，独立UsageTracker记录模型调用计费数据。

3.2 完整技术栈表格

3.3 底层关键实现逻辑

1. 多智能体通信：编排Skill读取项目本地配置文件，自动分发对应Subagent，子Agent独立加载小说原文，仅输出结构化摘要减少上下文占用；

2. 媒体后端解耦：统一接口规范隔离各厂商API差异，切换模型无需修改业务代码；

3. 任务队列隔离：图片、视频生成通道分离，避免长视频任务阻塞图片批量生成；

4. 数据库适配：开发本地使用轻量化SQLite，企业生产通过docker compose切换PostgreSQL，完整数据迁移脚本无缝切换；

5. 外部扩展：开放 /api/v1/agent/chat 流式接口，支持OpenClaw等第三方AI平台远程调用项目能力。

四、应用场景

1. 网文自媒体解说短视频：小说批量生成说书类竖屏短视频，适配抖音、视频号分发；

2. AI动态漫/短剧量产：小说改编动画剧集，自动分镜、统一角色，工作室批量产出；

3. 本地私有化内容生产：企业/工作室本地部署，素材不对外上传第三方云端，保障版权数据安全；

4. AI内容工作室自动化流水线：替代人工写剧本、画图、生成视频，降低单人创作时间成本；

5. 自定义模型二次开发：开发者基于统一Backend接口接入本地开源图文视频模型（Ollama、vLLM），搭建私有AIGC工作流；

6. 短剧前期快速原型：快速生成分镜成片给客户预览，减少传统影视前期制作成本。

五、使用方法

5.1 前置环境要求

设备安装Docker、Docker Compose，支持Windows/macOS/Linux全平台；最低内存推荐8G，生产环境16G以上。

5.2 本地简易部署（SQLite，新手推荐）

1. 克隆项目源码

git clone https://github.com/ArcReel/ArcReel.git
cd ArcReel/deploy

2. 复制环境变量模板

cp .env.example .env

3. 启动容器

docker compose up -d

4. 浏览器访问地址：http://localhost:1241

5.3 生产级部署（PostgreSQL，商用场景）

1. 进入生产部署目录

cd ArcReel/deploy/production
cp .env.example .env

2. 编辑.env文件，配置POSTGRES_PASSWORD数据库密码、AUTH_PASSWORD后台登录密码；

3. 启动生产容器：docker compose up -d

5.4 初始化配置步骤

1. 登录后台：默认用户名admin，未设置密码则自动生成密码写入.env文件；

2. 进入 /settings 设置页面完成核心配置：

• 配置Claude系列API Key，驱动AI智能体剧本生成；

• 至少配置一家图片、视频生成厂商API Key（火山方舟/OpenAI/Gemini/Grok任选）；

• 可选添加自定义兼容模型供应商；

3. 新建项目，上传小说文本，选择「说书模式/剧集动画模式」；

4. 按AI分步提示确认角色、分镜、画面风格，自动批量生成素材与视频；

5. 生成完成后导出完整MP4成片或剪映草稿ZIP。

六、竞品对比

选取2款主流同类AI视频创作工具做维度对比，分别为闭源云端工具Runway、开源本地短剧工具SkyReels，与ArcReel横向对比：

七、常见问题解答（FAQ）

Q1：ArcReel必须配置Claude API Key才能使用吗？

A：是的，项目的剧本拆分、角色提取、分镜规划等AI智能体推理逻辑基于Claude Agent SDK构建，必须填入有效的Anthropic API Key才能启动完整流水线；仅媒体素材生成的图文视频模型可自由选择火山方舟、OpenAI等厂商。

Q2：本地部署没有海外模型API，仅使用火山方舟能否完整运行？

A：完全可以。文本、图片、视频生成均可全部切换火山方舟Doubao Seed、Seedream、Seedance系列模型，国内网络可稳定调用，整套流程无需依赖海外厂商接口。

Q3：启动Docker后访问localhost:1241打不开页面是什么原因？

A：优先检查三点：①docker容器是否正常运行，执行docker compose ps查看服务状态；②本地1241端口是否被其他程序占用，修改.env内端口参数重启容器；③防火墙拦截本地访问，临时关闭防火墙重试。

Q4：生成视频时OpenAI后端提示video.seconds为None并崩溃，如何解决？

A：该bug项目0.7.1版本已修复，若使用旧版本代码，更新源码至最新main分支，重新拉取Docker镜像启动；临时方案可在项目设置手动固定视频时长参数。

Q5：能否接入本地Ollama开源大模型替代付费API？

A：支持。在设置页新增自定义供应商，填入Ollama本地地址http://localhost:11434/v1与任意密钥，系统自动识别本地模型，可用于文本剧本生成，但本地图像/视频模型需兼容OpenAI标准接口才可正常调用。

Q6：项目文件丢失如何备份迁移？

A：工作台内置项目导出功能，可将整套小说、角色、分镜、视频素材打包为归档文件；本地部署用户也可直接备份deploy目录下的数据库文件与public素材文件夹，更换设备后直接覆盖即可恢复。

Q7：切换项目级模型供应商后，原有画面风格会全部重置吗？

A：不会。分辨率、画面横竖屏、风格参考图等通用全局设置自动保留，仅当前项目图文视频生成厂商切换，历史生成素材不受影响。

Q8：生成前费用预估和实际消耗差距较大是什么原因？

A：预估基于标准分辨率、标准时长计算；实际消耗会因视频延展、多参考图、长文本Token增量产生浮动，系统会在费用面板展示预估与实际差值明细，方便核算成本。

八、相关链接

1. GitHub仓库地址：https://github.com/ArcReel/ArcReel

九、总结

ArcReel是一套开源免费、支持私有化Docker部署的全链路AI小说短视频生产工作台，依托多智能体Agent架构实现从小说文本到完整成片的自动化创作，兼容国内外主流图文视频大模型并支持本地自定义模型接入，通过角色图纸、线索追踪保障批量生成画面视觉统一，内置费用管控、版本回滚、剪映工程导出等工业化生产配套能力，相比闭源云端AI视频工具具备数据本地存储、无订阅费用、全流程可自定义改造的优势，适配自媒体创作者、短剧工作室、AI内容开发团队低成本批量产出AI短视频、动态漫内容。