injectlib/CapCutAPI

Fork 0

mirror of https://github.com/sun-guannan/CapCutAPI.git synced 2025-11-25 03:15:00 +08:00

Files

sun-guannan dc0a2f454c Update README-zh.md

2025-08-03 11:57:01 +08:00

4.8 KiB

Raw Blame History

CapCutAPI

轻量、灵活、易上手的剪映/CapCutAPI工具，构建全自动化视频剪辑/混剪流水线。

直接体验：https://www.capcutapi.top

👏👏👏👏 庆祝github 600星，送出价值6000点不记名云渲染券：17740F41-5ECB-44B1-AAAE-1C458A0EFF43

效果演示

MCP,创建属于自己的剪辑Agent

通过工具，将AI生成的图片，视频组合起来

项目功能

本项目是一个基于Python的剪映/CapCut处理工具，提供以下核心功能：

核心功能

草稿文件管理：创建、读取、修改和保存剪映/CapCut草稿文件
素材处理：支持视频、音频、图片、文本、贴纸等多种素材的添加和编辑
特效应用：支持添加转场、滤镜、蒙版、动画等多种特效
API服务：提供HTTP API接口，支持远程调用和自动化处理
AI集成：集成多种AI服务，支持智能生成字幕、文本和图像

主要API接口

/create_draft创建草稿
/add_video：添加视频素材到草稿
/add_audio：添加音频素材到草稿
/add_image：添加图片素材到草稿
/add_text：添加文本素材到草稿
/add_subtitle：添加字幕到草稿
/add_effect：添加特效到素材
/add_sticker：添加贴纸到草稿
/save_draft：保存草稿文件

配置说明

配置文件

项目支持通过配置文件进行自定义设置。要使用配置文件：

复制config.json.example为config.json
根据需要修改配置项

cp config.json.example config.json

环境配置

ffmpeg

本项目依赖于ffmpeg，您需要确保系统中已安装ffmpeg，并且将其添加到系统的环境变量中。

Python 环境

本项目需要 Python 3.8.20 版本，请确保您的系统已安装正确版本的 Python。

安装依赖

安装项目所需的依赖包：

pip install -r requirements.txt

运行服务器

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

python capcut_server.py

服务器启动后，您可以通过 API 接口访问相关功能。

使用示例

添加视频

import requests

response = requests.post("http://localhost:9001/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:9001/add_text", json={
    "text": "你好，世界！",
    "start": 0,
    "end": 3,
    "font": "思源黑体",
    "font_color": "#FF0000",
    "font_size": 30.0
})

print(response.json())

保存草稿

import requests

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

print(response.json())

也可以用 REST Client 的 rest_client_test.http 进行http测试，只需要安装对应的IDE插件

复制草稿到剪映/capcut草稿路径

调用save_draft会在服务器当前目录下生成一个dfd_开头的文件夹，将他复制到剪映/CapCut草稿目录，即可看到生成的草稿

项目特点

跨平台支持：同时支持剪映和CapCut国际版
自动化处理：支持批量处理和自动化工作流
丰富的API：提供全面的API接口，方便集成到其他系统
灵活的配置：通过配置文件实现灵活的功能定制
AI增强：集成多种AI服务，提升视频制作效率

进群交流

反馈问题
功能建议
最新消息

合作

你想要利用这个API批量制作出海视频吗？我提供免费的咨询服务，帮助你利用这个API制作。相应的，我要将工作流代码放到这个项目里公开出来。
有兴趣加入我们？我们的目标是提供稳定可靠的视频剪辑工具，方便融合AI生成的图片/视频/语音。如果你有兴趣，可以先从将工程里的中文翻译成英文开始！提交pr，我会看到。更深入的，还有MCP剪辑Agent, web剪辑端，云渲染这三个模块代码还没有开源出来。
联系方式微信：sguann 抖音：剪映草稿助手

4.8 KiB Raw Blame History Unescape Escape