導讀：
您是否厭倦了在剪映/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 或參與社區討論，獲取及時的支持。