GuanYixuan/pyCapCut

解决的问题

本项目提供了一种使用 Python 以编程方式生成和编辑 CapCut 草稿文件的方法。它允许用户自动化创建视频项目，包括添加媒体、文本、效果、转场和关键帧，这些项目随后可以通过桌面版 CapCut 应用程序打开并导出。

工作原理

它直接与 CapCut 使用的 draft_content.json 文件进行交互。用户可以使用该库的 Python 类定义视频结构，例如轨道、片段和效果。该工具处理 CapCut 草稿复杂的内部数据结构，支持基于模板的编辑、素材替换，以及使用微秒单位或人类可读的时间字符串进行精确的时间控制。

适用人群

该工具专为希望自动化重复性视频编辑任务、批量创建视频内容或构建利用 CapCut 渲染引擎的自定义视频生成流水线的创作者、开发者或剪辑师而设计。

主要亮点

• 程序化编辑：通过 Python 完全控制轨道、片段和媒体属性。
• 模板支持：加载现有草稿作为模板，在保留复杂样式的同时替换媒体、文本或特定片段。
• 丰富的功能集：支持关键帧、蒙版、色度键控、混合模式、动画和滤镜。
• 灵活的时间控制：支持微秒级精度和便捷的时间字符串（例如 "1.5s", "1m"）。
• SRT 集成：轻松将字幕文件导入到指定的文本轨道中。