CapCut Mate API

CapCut Mate API 是一款基于 FastAPI 构建的开源项目，为大模型（LLM）提供标准化的视频编辑能力。它通过自动化操作剪映（CapCut）草稿文件，实现了从素材添加、关键帧控制到云端渲染的全流程闭环。无论是独立部署还是集成到 Coze、n8n 等自动化工作流中，CapCut Mate 都能让普通用户或开发者轻松实现“一句话生成专业视频”的梦想。

核心功能亮点

• 🎬 全链路草稿管理：
  • 支持创建、获取、保存剪映草稿，实现视频项目的程序化控制。
  • 兼容剪映核心功能，确保生成的草稿可在客户端无缝打开与编辑。
• 🎥 丰富的素材与特效支持：
  • 多媒体导入：自动添加视频、音频、图片、贴纸及字幕。
  • 高级编辑：支持关键帧动画、文字样式定制、遮罩应用及特效叠加，满足精细化剪辑需求。
• ☁️ 云端渲染与导出：
  • 对接剪映云渲染服务，直接将自动化生成的草稿转化为最终视频文件，无需本地手动导出。
• 🛡️ 企业级开发规范：
  • 基于 FastAPI 构建，提供高性能 RESTful API。
  • 使用 Pydantic 进行严格的数据验证，确保请求参数的准确性与安全性。
  • 自动生成交互式 API 文档（Swagger UI），降低集成门槛。

技术栈

• 语言：Python 3.11+
• 框架：FastAPI (Web), Uvicorn (ASGI Server)
• 工具：uv (包管理与项目管理), Pydantic (数据验证), Passlib (加密)

快速开始

1. 环境准备

确保已安装 Python 3.11+ 及 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]

# 启动服务器
uv run main.py

启动后，访问 http://localhost:30000/docs 查看并测试 API。

3. Docker 部署（推荐）

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

应用场景

• AI 视频生成 Agent：结合 LLM 理解用户意图，自动调用 API 完成剪辑。
• 批量视频制作：通过 n8n 或 Coze 工作流，实现营销视频、新闻快讯的自动化生产。
• 个性化内容推荐：根据用户数据动态生成专属视频内容。