CapCutAPI
访问网站
扫码查看
复制链接

一个用于自动化剪映和CapCut视频编辑的Python工具

标签：AI视频 , API , CapCut , Python , 剪映 , 自动化 , 视频编辑 , 非官方接口

CapCutAPI

AI视频 / 视频编辑47 次浏览

综合介绍

CapCutAPI 是一个基于 Python 开发的非官方接口工具，它允许开发者通过编程方式操作“剪映”及其海外版“CapCut”的草稿文件，从而实现视频编辑的自动化。该项目提供了一套完整的解决方案，让用户可以创建、读取和修改剪映的草稿工程。你可以使用它来添加各种素材，包括视频、音频、图片和文字，还可以应用滤镜、转场、贴纸等多种特效。与其他工具不同的是，CapCutAPI 将这些复杂的操作封装成了简单的 HTTP 接口，这意味着你可以通过发送网络请求来控制剪映，将其集成到自己的自动化工作流程中。此外，该项目还集成了AI功能，能够智能生成字幕和图片，进一步提高了视频创作的效率。对于需要批量处理视频、进行程序化内容创作或希望将视频编辑能力整合到现有系统中的开发者和内容创作者来说，这是一个非常实用的工具。

功能列表

  • 草稿文件管理: 支持以编程方式创建、读取、修改和保存剪映（CapCut）的草稿文件。
  • 素材添加与编辑: 支持向视频轨道中添加视频、音频、图片、文字、贴纸等多种类型的素材。
  • 特效应用: 支持添加视频转场、滤镜、蒙版、动画等多种视觉效果。
  • HTTP API服务: 通过提供一系列 HTTP 接口，允许远程调用和自动化处理视频项目。
  • AI 功能集成: 集成了AI服务，可以实现字幕、文案和图片的智能生成。
  • 跨平台支持: 同时支持国内版的“剪映”和国际版的“CapCut”。
  • 灵活配置: 用户可通过配置文件进行自定义设置，以满足不同的使用需求。
  • 关键帧操作: 支持对视频素材添加关键帧，实现更精细的动画效果控制。

使用帮助

CapCutAPI 是一个功能强大的工具，它通过提供一套HTTP服务，让你能够用代码来控制剪映（CapCut），实现视频的自动化剪辑。以下是详细的安装和使用步骤，帮助你快速上手。

1. 环境准备

在使用 CapCutAPI 之前，你需要确保电脑上已经安装好了以下软件和环境：

  • FFmpeg: 这是一个处理音视频的基础工具，CapCutAPI 依赖它来处理媒体文件。
    • Windows: 下载 FFmpeg 后，需要将 bin 目录的路径添加到系统的环境变量 Path 中。
    • macOS: 可以使用 Homebrew 命令 brew install ffmpeg 来安装。
    • Linux: 可以使用包管理器进行安装，例如在 Ubuntu 上使用 sudo apt-get install ffmpeg。
  • Python 环境: 项目要求使用 Python 3.8 或更高版本。你可以在终端或命令行中输入 python --version 来检查当前版本。

2. 安装和配置

完成环境准备后，就可以开始安装和配置 CapCutAPI 了。

  • 下载项目文件:你可以从 GitHub 上克隆该项目的代码库： 
    git clone https://github.com/sun-guannan/CapCutAPI.git

    或者直接下载 ZIP 文件并解压。

  • 安装依赖:进入项目所在的文件夹，然后使用 pip 安装所有必需的 Python 库： 
    pip install -r requirements.txt
  • 配置文件:项目提供了一个配置模板文件 config.json.example。你需要复制一份并将其重命名为 config.json： 
    cp config.json.example config.json

    这个文件可以让你自定义一些高级功能，例如接入特定的AI服务。对于初次使用，可以暂时不修改它。

3. 启动服务

完成所有配置后，运行以下命令来启动 CapCutAPI 的后台服务：

python capcut_server.py

当你在终端看到服务成功启动的提示时，就意味着 API 已经准备好接收指令了。服务默认运行在 http://localhost:9001。

4. 如何使用API进行视频编辑

CapCutAPI 的核心是通过调用不同的 API 接口来实现视频剪辑。你可以使用任何支持发送 HTTP 请求的工具（如 Postman）或编程语言（如 Python 的 requests 库）来调用这些接口。

以下是一些基本操作的示例：

  • 第一步：创建一个新的剪辑草稿在开始剪辑前，首先需要创建一个新的项目草稿。这会自动生成一个唯一的 draft_id，用于后续的所有操作。
  • 第二步：添加视频素材接下来，向草稿中添加一个视频片段。你需要提供视频的URL或本地路径。 
    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": "SYSTEM",      # 字体名称，使用系统默认字体
"font_color": "#FFFFFF",  # 字体颜色，白色
"font_size": 30.0         # 字体大小
})
print(response.json())
  • 第四步：添加背景音乐为视频添加背景音乐，同样需要提供音频文件的 URL 或本地路径。 
    import requests
response = requests.post("http://localhost:9001/add_audio", json={
"audio_url": "http://example.com/music.mp3"
})
print(response.json())
  • 第五步：保存草稿完成所有编辑操作后，最关键的一步是保存草稿。这一步会将之前的所有操作整合成一个剪映草稿文件。 
    import requests
response = requests.post("http://localhost:9001/save_draft", json={
"draft_id": "之前创建时返回的ID",  # 确保使用正确的 draft_id
"draft_folder": "你的剪映草稿目录" # 你的电脑上剪映存放草稿的文件夹路径
})
print(response.json())

    调用 save_draft 后，项目目录下会生成一个 dfd_ 开头的文件夹。

  • 第六步：在剪映中查看将上一步中生成的 dfd_ 文件夹整个复制到你的剪映草稿目录（通常位于 User/Movies/JianyingPro/User Data/Projects）。完成后，重新打开剪映，你就能在项目列表中看到这个由代码自动生成的视频了。你可以继续在剪映中进行手动调整或直接导出。

这个工具极大地简化了重复性的剪辑工作，尤其适合需要批量生成短视频、自动添加字幕或根据模板创作内容的场景。

应用场景

  1. 自动化内容生产对于需要大量发布短视频的自媒体或营销团队，可以利用 CapCutAPI 自动化生成视频。例如，将产品图片、价格和介绍文案作为输入，程序可以自动匹配模板、背景音乐和转场效果，快速生成商品介绍视频。
  2. 批量视频处理如果你有大量的视频素材需要进行统一处理，例如为所有视频添加相同的水印、片头或片尾，CapCutAPI 可以实现一键批量操作。只需编写一个简单的脚本，就能自动为文件夹中的所有视频完成剪辑任务，极大地节省了手动操作的时间。
  3. 程序化视频广告在数字广告领域，可以根据不同的用户数据和投放渠道，动态生成定制化的视频广告。通过 API 接口，可以实时替换视频中的文字、图片和产品信息，为不同的目标受众生成最合适的广告内容。
  4. 与AI服务结合的智能剪辑CapCutAPI 支持集成 AI 功能，可以实现更智能的视频创作。例如，你可以将一篇长文章输入给 AI，让 AI 自动提炼核心内容并生成配音，然后通过 CapCutAPI 将这些内容与相关的素材拼接成一个解说视频。
  5. 个人开发者集成对于希望在自己的应用程序中集成视频编辑功能的开发者来说，CapCutAPI 提供了一个轻量级的解决方案。开发者可以通过这套 API 让用户在自己的应用内完成简单的视频剪辑操作，而无需从零开始开发一套复杂的视频编辑工具。

QA

  1. 这个项目是剪映官方的吗？不是。CapCutAPI 是由社区开发者创建的非官方开源项目，旨在为用户提供一种通过编程方式操作剪映的方法。它通过解析和修改剪映的草稿文件格式来实现自动化操作，并非官方发布的API。
  2. 使用这个工具有什么前置要求吗？需要一些基本的编程知识，特别是 Python。同时，你的电脑上需要安装 FFmpeg 和 Python 3.8 或更高版本。因为它是通过本地服务运行的，所以整个操作流程都需要在你的电脑上完成。
  3. 我可以添加自己的字体吗？可以。在调用 /add_text 接口时，你可以在 font 参数中指定系统里安装的字体名称。如果要使用特殊字体，需要先确保该字体已经安装在你的操作系统中。
  4. 这个工具支持实时视频处理吗？不支持。CapCutAPI 的工作原理是先对草稿文件进行修改和处理，最后生成一个完整的剪映项目文件。你需要将这个项目文件导入剪映后才能进行预览或导出，它无法像云端视频服务那样进行实时的视频流处理。
  5. 生成的草稿文件保存在哪里？当你调用 /save_draft 接口后，最终的草稿文件夹会生成在你运行 capcut_server.py 的项目目录下。你需要手动将这个文件夹（通常以 dfd_ 开头）复制到剪映指定的草稿路径中，才能在剪映软件里看到它。
微信微博Email复制链接