pyJianYingDraft 是一款轻量、灵活且易上手的 Python 库,专为视频创作者和开发者设计,用于自动生成与导出剪映(Jianying Pro)草稿。它支持剪映 5.9 及以下版本的模板读取和轨道修改,也兼容剪映 6 及以下版本的批量导出功能,使视频剪辑流水线实现全自动化,从素材导入到转场字幕配置均可程序化操作。
pyJianYingDraft是什么?
pyJianYingDraft 是一个 Python 库工具,帮助用户快速构建剪映草稿文件,自动处理音视频素材、轨道、转场、字幕等元素。通过模板模式和批量导出功能,它适合需要高效生成大量视频或构建自动化剪辑流水线的创作者和开发者,降低重复操作负担,同时兼容剪映 5 及以上版本的素材和轨道操作。
开源地址:https://github.com/GuanYixuan/pyJianYingDraft

核心功能
pyJianYingDraft 提供多维度视频剪辑控制和自动化处理:
- 模板模式 —— 加载剪映 5.9 及以下版本的
draft_content.json
模板,替换音视频素材和文本,导入轨道,提取贴纸、气泡、花字等元信息。 - 批量导出 —— 支持剪映 6 及以下版本批量导出草稿,可调分辨率与帧率。
- 素材与效果管理 —— 添加本地视频、图片、音频,支持片段起止、持续时间、播放速度调整,旋转、缩放、亮度及关键帧设置,蒙版、滤镜、入场/出场动画。
- 音频与轨道管理 —— 音频淡入淡出、音量关键帧、场景音效果,增加轨道并分层管理视频/滤镜/特效。
- 转场与字幕 —— 自定义转场时长与效果,导入
.srt
文件一键生成并批量格式化字幕,文本自动换行并支持关键帧动画。 - 示例功能 —— 背景填充、贴纸关键帧、花字气泡、文字描边及背景效果,快速验证脚本配置。
使用场景
pyJianYingDraft 适合各类需要程序化视频生成的场景:
人群/角色 | 场景描述 | 推荐指数 |
---|---|---|
内容创作者 | 需要快速生成带字幕、特效和转场的视频 | ★★★★★ |
自动化视频流水线 | 批量处理短视频或广告素材 | ★★★★★ |
开发者 | 构建视频生成工具或剪辑插件 | ★★★★☆ |
教育与培训 | 自动生成课程或演示视频 | ★★★★☆ |
操作指南
新手可在几分钟内上手 pyJianYingDraft:
- 安装库:
pip install pyJianYingDraft
推荐 Python 3.8 或 3.11,若出现
import
错误,可参考uiautomation
兼容问题修复。 - 在剪映中创建空草稿,并定位
draft_content.json
路径。 - 配置示例脚本
demo.py
的DUMP_PATH
。 - 运行脚本,自动生成包含视频、音频、文本、淡入淡出、转场及花字气泡效果的草稿。
- 打开生成草稿,检查时间轴及效果配置是否符合预期。
支持平台
- 剪映 5 及以上版本
- 支持 Windows、macOS 上 Python 环境运行
- Python 3.8 至 3.11 推荐使用
产品定价
pyJianYingDraft 为 开源免费 Python 库,可自由使用和二次开发,无额外付费要求。
常见问题
Q1:支持哪些剪映版本?
A1:模板模式支持剪映 5.9 及以下,批量导出支持剪映 6 及以下版本。
Q2:如何批量导出?
A2:使用批量导出功能,设置目标路径和导出参数即可自动生成视频文件。
Q3:是否需要剪映安装?
A3:需在本地安装剪映以供 pyJianYingDraft 调用进行草稿读取和导出。
Q4:是否支持字幕导入?
A4:支持导入 .srt
文件并自动生成关键帧字幕。
跳跳兔小结
pyJianYingDraft 为视频创作者和开发者提供了灵活、高效且可扩展的自动化剪辑工具。通过模板模式、批量导出及丰富的轨道和素材操作,它能够大幅提升视频生成效率,适合内容创作者、教育机构或短视频生产团队。若需要深度特效创作或高版本剪映新功能,需结合剪映原生功能使用。