视频编辑API工具

一个基于Python的CapCut视频编辑API工具,提供草稿文件管理、素材处理、效果应用和AI集成等功能,适用于视频编辑自动化。

  • by Capsnow467
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 Capsnow467/capcut-mcp-api

使用说明

CapCutAPI

开源CapCut API工具。

中文说明

项目特点

该项目是一个基于Python的CapCut处理工具,提供以下核心功能:

核心功能

  • 草稿文件管理:创建、读取、修改和保存CapCut草稿文件
  • 材料加工:支持添加和编辑各种材料,如视频、音频、图像、文本、贴纸等。
  • 效果应用:支持添加多种效果,如过渡、滤镜、蒙版、动画等。
  • API服务:提供HTTP API接口以支持远程调用和自动化处理
  • 人工智能集成:集成多种人工智能服务,支持字幕、文本和图像的智能生成

API主要接口

  • /create_draft:创建草稿
  • /add_video:在草稿中添加视频材料
  • /add_audio:在草稿中添加音频材料
  • /add_image:将图像素材添加到草稿中
  • /add_text:在草稿中添加文本材料
  • /add_subtitle:在草稿中添加字幕
  • /add_effect:为材质添加效果
  • /add_sticker:在草稿中添加贴纸
  • /save_draft:保存草稿文件

配置说明

配置文件

该项目支持通过配置文件进行自定义设置。要使用配置文件,请执行以下操作:

  1. 复制 config.json.example 到 config.json
  2. 根据需要修改配置项
cp config.json.example config.json

环境配置

FFmpeg

这个项目依赖于ffmpeg。您需要确保ffmpeg已安装在您的系统上并添加到系统的环境变量中。

Python环境

这个项目需要Python 3.8.20版本。请确保您的系统上安装了正确版本的Python。

再进行

为项目安装所需的依赖包:

pip install -r requirements.txt

运行服务器

完成配置和环境设置后,执行以下命令启动服务器:

python main.py

服务器启动后,您可以通过API接口访问相关函数。

使用示例

添加视频

import requests

response = requests.post("http://localhost:9000/add_video", json={
    "video_url": "http://example.com/video.mp4",
    "start": 0,
    "end": 10,
    "width": 1080,
    "height": 1920
})

print(response.json())

添加文本

import requests

response = requests.post("http://localhost:9000/add_text", json={
    "text": "Hello, World!",
    "start": 0,
    "end": 3,
    "font": "Source Han Sans",
    "font_color": "#FF0000",
    "font_size": 30.0
})

print(response.json())

保存草稿

import requests

response = requests.post("http://localhost:9000/save_draft", json={
    "draft_id": "123456",
    "draft_folder": "your capcut draft folder"
})

print(response.json())

将草稿复制到CapCut草稿路径

召唤 save_draft 将生成一个以开头的文件夹 dfd_ 在服务器的当前目录中。将此文件夹复制到CapCut草稿目录,您将能够看到生成的草稿。

配置MCP

在游标中配置MCP。在游标设置中,添加一个具有以下地址的MCP服务器 http://localhost:9000/mcp,然后您可以在游标中使用MCP。

在Claude配置中,添加以下内容:

{
    "mcpServers": {
        "capcut-mcp": {
            "type": "http",
            "url": "http://localhost:9000/mcp"
        }
    }
}

更多示例

请参阅 example.py 项目中的文件,其中包含更多使用示例,如添加音频和效果。

项目特点

  • 与跨平台支持:支持CapCut中国版和CapCut国际版
  • 自动处理:支持批处理和自动化工作流
  • 丰富的API:提供全面的API接口,以便轻松集成到其他系统中
  • 灵活配置:通过配置文件实现灵活的功能定制
  • AI增强:整合多种人工智能服务,提高视频制作效率