Horseplay（马上短剧）AI 短剧生成工具技术详解与部署指南

1 阅读

工具定位与适用人群

Horseplay（马上短剧）是一个面向个人创作者和小型团队的开源 AI 短剧生成工具。它用 Python 开发，把从写剧本到出成片的整套流程打包在一起。你只要给一个主题词，它就能批量产出多集风格统一的短剧。

文章配图

这个工具主要解决三个痛点：一是传统短剧制作环节太多，一个人很难跑通；二是 AI 生成内容容易“翻车”——同一角色在不同镜头里长得不一样，或者场景色调忽冷忽热；三是成本高，专业配音、剪辑、特效都得花钱。

文章配图

Horseplay 提供两种使用方式：有编程基础的人可以拉源码自己部署，还能二次开发；完全不懂代码的用户直接下载一个 EXE 文件，双击就能用，不用装 Python、不用配环境变量、也不用注册账号。

文章配图

核心功能拆解

文章配图

剧本自动化生成

剧本模块依赖大语言模型，目前支持 OpenAI GPT-4o 和 DeepSeek。你可以输入“都市甜宠”“悬疑复仇”这类关键词，它会自动生成包含场景、角色、台词的标准剧本格式。如果你手头有一篇小说或段子，也可以粘贴进去，让它改写成适合拍摄的分镜脚本。

生成后，你可以在界面里手动增删集数、修改某句台词，或者调整场景顺序。所有改动都会实时保存到项目文件里，下次打开还能接着改。

角色与场景的一致性控制

这是 Horseplay 最关键的设计。很多 AI 视频工具生成一集还行，但做系列剧时角色脸型、发型、服装经常变来变去，观众看得一头雾水。

Horseplay 的做法是：在项目创建阶段就让你为每个角色上传一张参考图，并填写人设描述（比如“25岁女律师，黑长直，常穿西装”）。后续所有图像和视频生成都会锁定这些特征，确保角色形象稳定。

场景也一样。你可以为“办公室”“咖啡馆”等常用场地单独建档案，上传参考图并标注光影、色调、布局要点。系统在生成分镜或视频时会优先匹配这些设定，避免同一场景在不同集里看起来像两个地方。

分镜与视频生成

分镜由 DALL-E 3 或 Stable Diffusion 驱动。剧本里的每一段场景描述会被自动转成画面，你还能指定镜头角度（比如特写、俯拍）、运镜方式（推拉摇移）和艺术风格（写实、动漫、油画等）。

如果某张分镜不满意，可以直接点“重绘”，或者微调提示词再试一次。确认分镜后，系统会调用视频模型生成动态片段。

目前支持的视频模型包括 Google Veo 3.1、OpenAI Sora 2 和 Runway Gen4 Turbo。输出格式兼容短视频主流的 9:16 竖屏和 16:9 横屏，分辨率可选 720P 或 1080P。

音频合成与同步

配音部分接入了 OpenAI TTS、ElevenLabs 和 Edge TTS。你可以为每个角色分配专属音色（比如“温柔女声”“低沉男中音”），系统会记住这个设置，保证多集配音音色一致。

除了人声，它还会根据场景自动添加背景音乐和环境音效。比如“雨夜街头”的场景会配上雨声和远处车流，“办公室”则会有键盘敲击和空调嗡鸣。音频和视频会自动对齐时间轴，导出时直接合成一体。

技术架构与目录结构

整个项目用 Python 3.10+ 编写，图形界面基于 PyQt6。AI 模型调用通过封装接口实现，媒体处理依赖 FFmpeg、OpenCV 和 Pydub。所有项目数据以 JSON 文件形式存储，轻量且易于迁移。

项目目录结构清晰：

  • src/：源代码，分 ui、core、ai_engine、database 四个子模块
  • resources/：配置文件、用户项目、场景素材
  • .venv/：Python 虚拟环境（源码部署时生成）
  • requirements.txt：依赖清单
  • main.py：程序入口

这种结构方便开发者快速定位功能模块。比如想替换 TTS 引擎，只需修改 ai_engine/audio/ 下的对应文件，不用动 UI 或核心逻辑。

部署与运行步骤

源码部署（推荐开发者）

  1. 从百度网盘下载源码包（提取码 5555），解压到本地目录。
  2. 创建虚拟环境：
    python -m venv .venv
.venv\Scripts\activate  # Windows
source .venv/bin/activate  # Linux/macOS
  3. 安装依赖：
    pip install -r requirements.txt
  4. 复制配置模板：
    copy resources\config\config.example.json resources\config\config.json  # Windows
cp resources/config/config.example.json resources/config/config.json  # Linux/macOS
  5. 编辑 config.json，填入各平台 API 密钥（OpenAI、DeepSeek、Google、ElevenLabs 等）。
  6. 启动程序：
    python src/main.py

注意：必须提前安装 FFmpeg 并加入系统 PATH，否则视频合成会失败。

独立 EXE 运行（推荐普通用户）

  1. 从百度网盘下载独立版 EXE（提取码 5555）。
  2. 解压后直接双击 Horseplay.exe 即可启动。
  3. 首次使用需在“全局设置”里配置 API 密钥，之后所有功能都能正常使用。

这种方式省去了环境配置的麻烦，特别适合只想快速试用的创作者。不过要注意，EXE 版本更新频率可能低于源码，新功能会稍晚支持。

标准使用流程

  1. 新建项目：设置故事类型（如“校园恋爱”）、总集数（建议先试 3 集）、画幅（竖屏/横屏）和分辨率。
  2. 生成剧本：输入核心关键词，AI 自动生成分集内容。可手动调整台词或删减场景。
  3. 配置角色：系统自动识别剧本中的角色名，你需补充人设、上传参考图，并绑定 TTS 音色。
  4. 设定场景：为每集选择或新建场景档案，上传参考图以固定视觉风格。
  5. 生成分镜：基于剧本自动出图，可调整镜头参数或单张重绘。
  6. 视频生成：选择视频模型（如 Veo 或 Sora），批量渲染分镜为动态片段。
  7. 音频合成：系统自动生成配音、BGM 和音效，并与视频对齐。
  8. 导出成品：合并所有片段，输出 MP4 文件。

整个流程在同一个界面完成，无需切换软件。项目文件会自动保存在 resources/projects/ 下，方便后续修改或复用素材。

当前限制与注意事项

  • 视频生成依赖第三方 API，费用较高。建议先用低分辨率测试，确认效果后再跑高清。
  • 角色一致性在复杂动作（如转身、遮挡）下仍可能出现偏差，需人工检查关键帧。
  • 中文剧本生成质量优于英文，因训练数据以中文短剧为主。
  • EXE 版本仅支持 Windows，Mac 和 Linux 用户需用源码部署。

Horseplay 的目标不是取代专业制作，而是降低 AI 短剧的入门门槛。对于想快速验证创意、批量生产轻量内容的创作者来说，它已经能覆盖从 0 到 1 的大部分工作。