pyJianYingDraft：剪映草稿自动化工具

简介介绍

pyJianYingDraft 是一个用 Python 写的剪映（Jianying Pro）草稿生成库，面向视频创作者和自动化工作流开发者。它能自动生成并导出剪映草稿，简化了全自动视频剪辑与混剪流水线的搭建流程，尤其适合需要批量处理视频素材的场景。它开源免费（Apache-2.0 协议），安装只需要 pip install pyJianYingDraft，不需要注册任何账号。

功能特点

• 草稿生成与导出 ：支持自动生成剪映草稿文件，并实现批量导出功能，满足高效视频制作需求。
• 版本兼容性强 ：在剪映 5.9 及以下版本中支持模板模式下的草稿读取与修改，确保向后兼容性；同时在剪映 6 及以下版本中实现批量导出，适应不同版本的用户需求。
• 丰富的素材与轨道操作 ：兼容剪映 5 及以上版本的丰富素材库和轨道操作功能，为创作者提供更多创意空间和灵活的编辑选项。
• 简易集成 ：作为 Python 库，易于集成到现有自动化脚本或复杂视频处理 pipeline 中，降低开发门槛。

使用场景

跨平台视频处理 ：结合其他工具和库，构建跨平台的视频处理 workflow，实现从不同来源的素材汇聚到最终视频输出的全流程自动化。将教学视频、学术讲座等内容转录为文字，便于学习和研究，提高信息获取效率。

自动化视频生产 ：在需要批量生成视频内容的场景（如在线教育课程制作、短视频营销内容批量生产等）中，通过与自动化脚本结合，实现从素材到成品的高效转换。

模板化内容创作 ：利用模板模式下的草稿读取与修改功能，快速定制符合品牌风格或特定主题的视频内容，保持内容一致性。

安装与快速上手

1. 安装：pip install pyJianYingDraft 推荐 Python 3.8 或 3.11。若发生 import 失败，可参考相关 issue 排查 uiautomation 兼容问题。
2. 示例演练：
   • 在剪映中创建空草稿，定位其 draft_content.json 路径
   • 设置示例脚本 demo.py 的 DUMP_PATH，运行后自动生成包含视频、音频、文本、淡入淡出、转场及花字气泡等效果的草稿
   • 重新打开草稿，验证时间轴及各项效果配置

亮点与坑

版本对不上，功能就少一半。

剪映版本是硬门槛：README 的功能表逐项标了 5.9 与新版（10.8）的差异，其中批量导出依赖旧版剪映的可见控件，剪映 6 及以下可用，剪映 7 及以上不支持；新版的模板模式还要额外挂 fallback_loader 才能读到 draft_content.json。 非 Windows 平台只能生成草稿：Linux 和 macOS 支持草稿生成与模板模式，但不支持自动导出，生成的草稿仍要拿到 Windows 版剪映里导出。 打开草稿时可能自动下载未缓存资源：剪映加载未缓存的特效、滤镜和转场要走联网，超时就会显示「xx加载失败」，README 说这个问题在 5.9 上更常见；没缓存过的字体还得再打开一次草稿才会生效。 声音成曲和轨道顺序要注意：声音成曲效果在 5.9 上不生效，新版（10.8）从其它草稿导入的轨道可能出现顺序错乱。

项目地址

GitHub地址：https://github.com/GuanYixuan/pyJianYingDraft

结论

它省掉的是搭草稿结构这段重复劳动，不是把剪映本身替代掉：批量导出、资源缓存这些坑都落在剪映那一侧，跨平台生成出来的草稿也仍然要在 Windows 版剪映里导出成片。

相关推荐

搭建混剪流水线往往要先囤素材：sparkdownloader 支持 B站、抖音、小红书等平台媒体解析下载，与 pyJianYingDraft 搭配可以打通「下载素材——生成草稿——批量导出」的完整流程。