CapCut Mate API 最新版

在 AI 视频生成领域，大模型往往擅长“创意”却拙于“执行”。CapCut Mate API 是一款完全开源、基于 FastAPI 构建的剪映（CapCut）草稿自动化助手，它通过将剪映的核心编辑能力封装为标准 RESTful API，让大模型能够直接操控视频剪辑的全流程。

无论是独立部署还是融入 Coze、n8n 等自动化工作流，CapCut Mate API 都能让普通用户或开发者快速构建出具备专业级视频编辑能力的智能应用，真正实现“对话即剪辑”。

核心功能：全流程自动化剪辑

CapCut Mate API 并非简单的脚本工具，而是对剪映草稿文件（.draft）的深度解析与重构，覆盖了从素材导入到最终渲染的完整链路：

• 🎬 草稿全生命周期管理
  支持创建新草稿、读取现有草稿结构、保存修改后的草稿，让大模型可以像操作代码库一样管理视频项目。
• 🎥 多维素材灵活添加
  提供丰富的接口，支持程序化添加视频轨道、背景音乐、图片、贴纸、字幕、特效及遮罩层。大模型可根据脚本内容，自动匹配素材并精准对齐时间轴。
• 🔧 专业级精细控制
  不仅限于基础拼接，更支持关键帧动画、文字样式定制（字体、颜色、描边）、转场特效及图层混合模式等高级功能，满足复杂创意需求。
• 📤 云端渲染闭环
  编辑完成的草稿可直接对接剪映云渲染服务，一键生成高清最终视频，无需本地高性能显卡支持。
• 🛡️ 严谨的数据验证
  基于 Pydantic 构建严格的数据模型，确保所有传入参数的合法性，避免因格式错误导致的渲染失败。

技术架构：现代、高效、易扩展

项目采用现代化的 Python 技术栈，专为高并发和易集成设计：

• FastAPI：提供高性能异步 Web 服务，自动生成交互式 API 文档（Swagger UI）。
• Pydantic：强大的数据验证与序列化能力。
• uv：新一代极速 Python 包管理器，大幅缩短安装与依赖解析时间。
• Docker 支持：提供完整的 docker-compose 配置，实现一键容器化部署。

快速上手：三步启动服务

CapCut Mate API 的安装极其简便，推荐使用 uv 进行环境管理。

1. 安装 uv 包管理器

• Windows:

  powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  

• Linux/macOS:

  sh -c "$(curl -LsSf https://astral.sh/uv/install.sh)"
  

2. 克隆项目并安装依赖

git clone git@github.com:Hommy-master/capcut-mate.git
cd capcut-mate
uv sync
# Windows 用户需额外执行：
uv pip install -e .[windows]

3. 启动服务

uv run main.py

启动后，访问 http://localhost:30000/docs 即可看到自动生成的交互式 API 文档，直接在线测试所有接口。

🐳 Docker 一键部署（推荐）
若希望隔离环境或快速上线，可使用 Docker：

git clone https://github.com/Hommy-master/capcut-mate.git
cd capcut-mate
docker-compose pull && docker-compose up -d

应用场景：赋能 AI 视频工作流

• 智能短视频生成：结合大模型生成的脚本，自动搜索素材、添加字幕、配乐并导出成片。
• 批量视频处理：通过 n8n 或 Coze 编排工作流，一次性处理数百个视频的片头片尾替换、水印添加等任务。
• 个性化视频营销：根据用户数据，动态生成千人千面的营销视频，大幅提升转化率。
• 教育课件制作：自动将图文教案转化为带语音解说和动画效果的视频课程。