开源项目CapCutAPI：解放生产力，剪映/CapCut全自动批量剪辑 + AI 字幕一键生成

 

导读：
您是否厌倦了在剪映/CapCut中手动拖拽素材、添加特效的繁琐过程？现在，一款名为 CapCutAPI 的开源 Python 工具将彻底改变您的视频剪辑体验。它能够通过脚本实现视频剪辑的自动化，包括创建草稿、添加多种素材、应用丰富特效、AI生成字幕，甚至支持远程接口调用，极大地提升了开发者的剪辑效率。

---

一、 CapCutAPI 简介：自动化视频剪辑的利器

CapCutAPI 是由开发者 sun‑guannan 在 GitHub 上开源的一款强大的 Python 工具。它的核心功能是让开发者能够通过编写脚本来自动化控制国产剪映或国际版 CapCut 的视频剪辑流程。这意味着您可以告别繁琐的手动操作，实现诸如创建项目草稿、精准添加视频、音频、图片、文本等素材、应用各种酷炫的和滤镜效果、利用 AI 技术自动生成字幕，乃至通过远程接口进行集成和调用。

如果您想深入了解或贡献代码，可以访问其官方 GitHub 仓库：https://github.com/sun-guannan/CapCutAPI

二、 核心亮点：赋能高效剪辑

• 草稿文件精细化管理： CapCutAPI 能够对 CapCut 的草稿文件进行创建、读取、修改和保存操作，尤其适合需要批量处理大量视频素材的场景，显著提升工作效率。
• 全方位素材支持： 无论是视频、音频、图片，还是生动的文本和贴纸，CapCutAPI 都能轻松添加至您的剪辑项目。
• 特效库丰富多样： 内置了丰富的、滤镜、蒙版、动画等效果，您可以通过简单的接口调用，为视频增添专业级的视觉表现力。
• HTTP API 服务： 提供 RESTful 风格的接口，方便与其他自动化流程或系统进行集成，实现远程控制和自动化工作流。
• AI 能力集成： 集成了语音识别等先进 AI 服务，能够自动为您生成字幕，极大地节省了人工校对的时间，提升了内容的易读性。
• 跨平台兼容性： 该工具兼容国产剪映和国际版 CapCut 的桌面版本，通过简单的配置即可切换使用环境，满足不同用户的需求。

三、 技术栈解析

CapCutAPI 的技术实现基于以下关键组件：

• 编程语言： 主要使用 Python（推荐使用 3.8.20 版本）进行开发。
• 外部依赖： 依赖强大的 ffmpeg 工具来处理视频相关的各种操作。
• API 模式： 采用 RESTful HTTP 接口设计，支持通过脚本或远程服务进行调用。
• 草稿格式： 能够处理 CapCut 的本地草稿文件，其内部结构通常表现为 .draft 文件夹。
• 跨平台支持： 兼容 Windows 和 macOS 操作系统上的剪映和 CapCut 桌面版本。

四、 部署与运行指南

遵循官方的部署流程，您可以轻松启动 CapCutAPI 服务：

1. 环境准备：
   • 确保已安装 Python 3.8.20。
   • 安装 ffmpeg，并将其添加到系统环境变量中，确保在命令行中可以直接执行 ffmpeg 命令。
2. 下载项目并安装依赖：
   • 使用 Git 克隆项目仓库：git clone https://github.com/sun-guannan/CapCutAPI.git
   • 进入项目目录：cd CapCutAPI
   • 安装所需的 Python 依赖：pip install -r requirements.txt
3. 配置服务并启动：
   • 复制示例配置文件：cp config.json.example config.json
   • 编辑 config.json 文件，根据您的需求修改端口号、CapCut 版本标识、AI 服务密钥等配置项。
   • 启动服务：python capcut_server.py

   默认情况下，服务将在 9000 端口（如果 config.json 中指定为 9001，则以实际配置为准）。启动成功后，您就可以通过 API 接口来控制剪辑流程了。

五、 使用示例：API 调用演示

以下是一些基本的 API 调用示例，展示了如何通过 Python 的 requests 库与 CapCutAPI 进行交互：

1. 创建草稿：

   import requests
   res = requests.post("http://localhost:9000/create_draft")
   draft_id = res.json().get("draft_id")
   print("Draft ID:",draft_id)
   

2. 添加素材：

   # 添加视频素材
   requests.post("http://localhost:9000/add_video",json={
       "draft_id": draft_id,"video_url": "http://example.com/video.mp4","start": 0,"end": 10,"width": 1080,"height": 1920
   })
   
   # 添加文本素材
   requests.post("http://localhost:9000/add_text",json={
       "draft_id": draft_id,"text": "Hello,World!","start": 0,"end": 3,"font": "ZY_Courage","font_color": "#FF0000","font_size": 30.0
   })
   

3. 添加特效或字幕：

   # 添加特效
   requests.post("http://localhost:9000/add_effect",json={
       "draft_id": draft_id,"effect": "fade","duration": 1.0
   })
   
   # AI 字幕（需在 config.json 中配置 AI 服务）
   requests.post("http://localhost:9000/add_subtitle",json={
       "draft_id": draft_id,"language": "zh-CN"
   })
   

4. 保存并生成草稿文件：

   requests.post("http://localhost:9000/save_draft",json={
       "draft_id": draft_id,"draft_folder": "你的剪映草稿目录"
   })
   

   执行此操作后，将在服务端当前目录下生成一个以 dfd_ 开头的文件夹。将此文件夹复制到您的剪映/CapCut 草稿路径下，即可在软件中打开并查看。

更多关于添加音频、贴纸等素材的案例，请参考项目中的 example.py 文件。

主要 API 接口列表：

• /create_draft：创建新的视频草稿。
• /add_video：向草稿中添加视频素材。
• /add_audio：向草稿中添加音频素材。
• /add_image：向草稿中添加图片素材。
• /add_text：向草稿中添加文本元素。
• /add_subtitle：向草稿中添加字幕。
• /add_effect：为素材应用特效。
• /add_sticker：向草稿中添加贴纸。
• /save_draft：将当前草稿保存为文件。

六、 适用场景：解放生产力

CapCutAPI 的自动化能力使其在多种场景下都能发挥巨大作用：

• 批量短视频生成： 无论是电商宣传片、在线课程视频，还是社交媒体上的内容，都可以通过批量生成的方式快速产出。
• 自动字幕生成： 利用 AI 语音识别技术，自动生成 .srt 或 .vtt 字幕文件，显著提高视频内容的传播效率和可访问性。
• 模板化剪辑输出： 快速应用统一的片头、水印、风格，实现高效的批量视频输出。
• 集成自动化系统： 能够无缝对接 CI/CD 流程、内容分发系统等，构建更完整的自动化工作流。

💡 小贴士与建议

• 该项目尚处于活跃开发阶段，API 接口和功能可能会有所调整。首次使用时，请务必仔细阅读 README.md 和 example.py 文件。
• 如果 API 调用出现问题，请确认剪映/CapCut 软件已正常运行，并检查网络连接是否稳定。
• 建议优先使用桌面版 CapCut，移动端的兼容性可能存在局限。
• 在使用过程中遇到任何疑问或问题，欢迎在 GitHub 上提交 issue 或参与社区讨论，获取及时的支持。