# 通过CapCutAPI连接AI生成的一切 [在线体验](https://www.capcutapi.top)
``` 👏👏👏👏 庆祝github 700星，送出价值7000点不记名云渲染券：08B88A2C-1D16-4CE1-982E-E3732F2655F3 ```
## 项目概览 **CapCutAPI** 是一款强大的云端 剪辑 API，它赋予您对 AI 生成素材（包括图片、音频、视频和文字）的精确控制权。 它提供了精确的编辑能力来拼接原始的 AI 输出，例如给视频变速或将图片镜像反转。这种能力有效地解决了 AI 生成的结果缺乏精确控制，难以复制的问题，让您能够轻松地将创意想法转化为精致的视频。 所有这些功能均旨在对标剪映软件的功能，确保您在云端也能获得熟悉且高效的剪辑体验。 ### 核心优势 1. 通过API的方式，提供对标剪映/CapCut的剪辑能力。 2. 可以在网页实时预览剪辑结果，无需下载，极大方便工作流开发。 3. 可以下载剪辑结果，并导入到剪映/CapCut中二次编辑。 4. 可以利用API将剪辑结果生成视频，实现全云端操作。 ## 效果展示
**MCP,创建属于自己的剪辑Agent** [![AI Cut](https://img.youtube.com/vi/fBqy6WFC78E/hqdefault.jpg)](https://www.youtube.com/watch?v=fBqy6WFC78E) **通过CapCutAPI，将AI生成的图片，视频组合起来** [![Airbnb](https://img.youtube.com/vi/1zmQWt13Dx0/hqdefault.jpg)](https://www.youtube.com/watch?v=1zmQWt13Dx0) [![Horse](https://img.youtube.com/vi/IF1RDFGOtEU/hqdefault.jpg)](https://www.youtube.com/watch?v=IF1RDFGOtEU) [![Song](https://img.youtube.com/vi/rGNLE_slAJ8/hqdefault.jpg)](https://www.youtube.com/watch?v=rGNLE_slAJ8)
## 核心功能 | 功能模块 | API | MCP 协议 | 描述 | |---------|----------|----------|------| | **草稿管理** | ✅ | ✅ | 创建、保存剪映/CapCut草稿文件 | | **视频处理** | ✅ | ✅ | 多格式视频导入、剪辑、转场、特效 | | **音频编辑** | ✅ | ✅ | 音频轨道、音量控制、音效处理 | | **图像处理** | ✅ | ✅ | 图片导入、动画、蒙版、滤镜 | | **文本编辑** | ✅ | ✅ | 多样式文本、阴影、背景、动画 | | **字幕系统** | ✅ | ✅ | SRT 字幕导入、样式设置、时间同步 | | **特效引擎** | ✅ | ✅ | 视觉特效、滤镜、转场动画 | | **贴纸系统** | ✅ | ✅ | 贴纸素材、位置控制、动画效果 | | **关键帧** | ✅ | ✅ | 属性动画、时间轴控制、缓动函数 | | **媒体分析** | ✅ | ✅ | 视频时长获取、格式检测 | ## 快速开始 ### 1. 系统要求 - Python 3.10+ - 剪映 或 CapCut 国际版 - FFmpeg ### 2. 安装部署 ```bash # 1. 克隆项目 git clone https://github.com/sun-guannan/CapCutAPI.git cd CapCutAPI # 2. 创建虚拟环境 (推荐) python -m venv venv-capcut source venv-capcut/bin/activate # Linux/macOS # 或 venv-capcut\Scripts\activate # Windows # 3. 安装依赖 pip install -r requirements.txt # HTTP API 基础依赖 pip install -r requirements-mcp.txt # MCP 协议支持 (可选) # 4. 配置文件 cp config.json.example config.json # 根据需要编辑 config.json ``` ### 3. 启动服务 ```bash python capcut_server.py # 启动HTTP API服务器, 默认端口: 9001 python mcp_server.py # 启动 MCP 协议服务，支持 stdio 通信 ``` ## MCP 集成指南 [MCP 文档](./MCP_文档_中文.md) • [MCP English Guide](./MCP_Documentation_English.md) ### 1. 客户端配置 创建或更新 `mcp_config.json` 配置文件： ```json { "mcpServers": { "capcut-api": { "command": "python3", "args": ["mcp_server.py"], "cwd": "/path/to/CapCutAPI", "env": { "PYTHONPATH": "/path/to/CapCutAPI", "DEBUG": "0" } } } } ``` ### 2. 连接测试 ```bash # 测试 MCP 连接 python test_mcp_client.py # 预期输出 ✅ MCP 服务器启动成功 ✅ 获取到 11 个可用工具 ✅ 草稿创建测试通过 ``` ## 使用示例 ### 1. API 示例 添加视频素材 ```python import requests # 添加背景视频 response = requests.post("http://localhost:9001/add_video", json={ "video_url": "https://example.com/background.mp4", "start": 0, "end": 10 "volume": 0.8, "transition": "fade_in" }) print(f"视频添加结果: {response.json()}") ``` 创建样式文本 ```python import requests # 添加标题文字 response = requests.post("http://localhost:9001/add_text", json={ "text": "欢迎使用 CapCutAPI", "start": 0, "end": 5, "font": "思源黑体", "font_color": "#FFD700", "font_size": 48, "shadow_enabled": True, "background_color": "#000000" }) print(f"文本添加结果: {response.json()}") ``` 可以在`example.py`文件中获取更多示例。 ### 2. MCP 协议示例 完整工作流程 ```python # 1. 创建新项目 draft = mcp_client.call_tool("create_draft", { "width": 1080, "height": 1920 }) draft_id = draft["result"]["draft_id"] # 2. 添加背景视频 mcp_client.call_tool("add_video", { "video_url": "https://example.com/bg.mp4", "draft_id": draft_id, "start": 0, "end": 10, "volume": 0.6 }) # 3. 添加标题文字 mcp_client.call_tool("add_text", { "text": "AI 驱动的视频制作", "draft_id": draft_id, "start": 1, "end": 6, "font_size": 56, "shadow_enabled": True, "background_color": "#1E1E1E" }) # 4. 添加关键帧动画 mcp_client.call_tool("add_video_keyframe", { "draft_id": draft_id, "track_name": "main", "property_types": ["scale_x", "scale_y", "alpha"], "times": [0, 2, 4], "values": ["1.0", "1.2", "0.8"] }) # 5. 保存项目 result = mcp_client.call_tool("save_draft", { "draft_id": draft_id }) print(f"项目已保存: {result['result']['draft_url']}") ``` 高级文本效果 ```python # 多样式彩色文本 mcp_client.call_tool("add_text", { "text": "彩色文字效果展示", "draft_id": draft_id, "start": 2, "end": 8, "font_size": 42, "shadow_enabled": True, "shadow_color": "#FFFFFF", "background_alpha": 0.8, "background_round_radius": 20, "text_styles": [ {"start": 0, "end": 2, "font_color": "#FF6B6B"}, {"start": 2, "end": 4, "font_color": "#4ECDC4"}, {"start": 4, "end": 6, "font_color": "#45B7D1"} ] }) ``` ### 3. 下载草稿 调用 `save_draft` 会在`capcut_server.py`当前目录下生成一个 `dfd_` 开头的文件夹，将其复制到剪映/CapCut 草稿目录，即可在应用中看到生成的草稿。 ## 模版 我们汇总了一些模版，放在`pattern`文件夹下。 ## 社区与支持 我们欢迎各种形式的贡献！我们的迭代规则： - 禁止直接向main提交pr - 可以向dev分支提交pr - 每周一从dev合并到main分支，并发版 ## 进群交流 ![交流群](https://github.com/user-attachments/assets/46ad102b-39cb-428f-a999-3ed04962f372) - 反馈问题 - 功能建议 - 最新消息 ### 🤝 合作机会 - **出海视频制作**: 想要利用这个API批量制作出海视频吗？我提供免费的咨询服务，帮助你利用这个API制作。相应的，我要将制作的工作流模板放到这个项目中的template目录中**开源**出来。 - **加入我们**: 我们的目标是提供稳定可靠的视频剪辑工具，方便融合AI生成的图片/视频/语音。如果你有兴趣，可以先从将工程里的中文翻译成英文开始！提交pr，我会看到。更深入的，还有MCP剪辑Agent, web剪辑端，云渲染这三个模块代码还没有开源出来。 - **联系方式**: - 微信：sguann - 抖音：剪映草稿助手 ## 📈 Star History
[![Star History Chart](https://api.star-history.com/svg?repos=sun-guannan/CapCutAPI&type=Date)](https://www.star-history.com/#sun-guannan/CapCutAPI&Date) ![GitHub repo size](https://img.shields.io/github/repo-size/sun-guannan/CapCutAPI?style=flat-square) ![GitHub code size](https://img.shields.io/github/languages/code-size/sun-guannan/CapCutAPI?style=flat-square) ![GitHub issues](https://img.shields.io/github/issues/sun-guannan/CapCutAPI?style=flat-square) ![GitHub pull requests](https://img.shields.io/github/issues-pr/sun-guannan/CapCutAPI?style=flat-square) ![GitHub last commit](https://img.shields.io/github/last-commit/sun-guannan/CapCutAPI?style=flat-square)
*Made with ❤️ by the CapCutAPI Community*