CapCut Mate API

Project Introduction

CapCut Mate API is a completely open-source and free Jianying draft automation assistant built on FastAPI, supporting independent deployment. This project focuses on empowering large models with basic video editing capabilities, providing out-of-the-box video editing Skills, and has fully automated the entire Jianying core functionality workflow. It can directly connect with large models to achieve diverse intelligent video editing, enabling ordinary users to quickly create professional and advanced video works.

Flexible project usage: Can be independently deployed, or combined with Coze or n8n to build automated workflows, and can also connect with Jianying to achieve cloud rendering, directly generating final videos from drafts.

Project Resources

• ⭐ Jianying Assistant
• 🔌 Jianying Assistant - Coze Plugin
• 🔗 Workflow Examples

⭐ If you find this project helpful, please give us a Star! Your support is the greatest motivation for me to continuously maintain and improve the project 😊

Features

• 🎬 Draft Management: Create draft, get draft, save draft
• 🎥 Material Addition: Add videos, audios, images, stickers, subtitles, effects, masks, etc.
• 🔧 Advanced Functions: Keyframe control, text styles, animation effects, etc.
• 📤 Video Export: Cloud rendering to generate final video
• 🛡️ Data Validation: Using Pydantic for request data validation
• 📖 RESTful API: Compliant with standard API design specifications
• 📚 Auto Documentation: FastAPI automatically generates interactive API documentation

Tech Stack

• Python 3.11+
• FastAPI: High-performance web framework
• Pydantic: Data validation and model definition
• Passlib: Password encryption (if using user authentication)
• Uvicorn: ASGI server
• uv: Python package manager and project management tool

Quick Start

Prerequisites

• Python 3.11+
• uv: Python package manager and project management tool

Installation:

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)"

Installation Steps

1. Clone the project

   git clone git@github.com:Hommy-master/capcut-mate.git
   cd capcut-mate

2. Install dependencies

   
   # Install dependencies
   uv sync

Additional execution for Windows

uv pip install -e .[windows]

3. Start the server
```bash
uv run main.py

1. Access API documentation After starting, visit http://localhost:30000/docs to view the automatically generated interactive API documentation

Docker Deployment

Quick Deployment (Recommended)

📺 Video Tutorial: CapCut Mate Private Deployment Complete Tutorial

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

After deployment, access the API documentation at: http://localhost:30000/docs

One-Click Import Coze Plugin

1. Open Coze platform: https://coze.cn/home

   

2. Add Plugin

   

3. Import Plugin

   

4. Upload the openapi.yaml file in the current project directory

   

5. Complete file upload

   

6. Complete logo replacement

   

7. Enable Plugin

   

API Documentation

The following are the core interfaces provided by CapCut Mate API, supporting a complete video creation workflow:

🏗️ Draft Management

🎥 Video Materials

🎵 Audio Processing

📝 Text Subtitles

✨ Effects & Animations

🎨 Animation Resources

🎬 Video Generation

🚀 Quick Tools

🛠️ Utility Tools

API Usage Examples

Workflow Examples

Explore real-world workflow examples to learn how to integrate CapCut Mate with automation platforms like Coze and n8n:

👉 View Workflow Examples

Create Draft

curl -X POST "http://localhost:30000/openapi/capcut-mate/v1/create_draft" \
-H "Content-Type: application/json" \
-d '{"width": 1080, "height": 1920}'

Add Videos

video_infos is a JSON string (not a nested JSON array). Each item must include video_url, start, and end (microseconds on the timeline). See add_videos for optional fields.

curl -X POST "http://localhost:30000/openapi/capcut-mate/v1/add_videos" \
-H "Content-Type: application/json" \
-d '{
  "draft_url": "http://localhost:30000/openapi/capcut-mate/v1/get_draft?draft_id=20251126212753cab03392",
  "video_infos": "[{\"video_url\": \"https://example.com/video.mp4\", \"start\": 0, \"end\": 1000000}]"
}'

API Documentation

• Local Access: http://localhost:30000/docs
• ReDoc Version: http://localhost:30000/redoc

Jianying Assistant Client

The Jianying Assistant client provides a convenient desktop interface. Here are the startup methods:

macOS Sandbox Permissions Guide

When running on macOS, the application may request access permissions for specific folders. Please follow these steps:

1. If permission prompts appear during the first run, allow the application to access the required folders
2. For manual configuration, go to System Preferences > Security & Privacy > Privacy > Folder Access
3. Ensure the CapCut Mate application is added to the allowed list

For more details, please refer to the macOS Sandbox Permissions Configuration Guide.

1. Install Dependencies

# Switch npm mirror source - for Windows
set ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/

# Switch yarn mirror source - for Linux or macOS
export ELECTRON_MIRROR="https://npmmirror.com/mirrors/electron/"

# Install dependencies
npm install --verbose

1. Start the Project

npm run web:dev
npm start

Contact

Type	Method	Description
📱 WeChat Group		Open Source Community Discussion Group
💬 WeChat		Business Cooperation
📧 Email	taohongmin51@gmail.com	Technical Support