Hommy88-CSDN博客

capcut-mate 通过清晰的分层架构与完善的 API 描述，实现了从草稿创建、素材编排到云端渲染与本地导出的全链路自动化。：完善的开源免费、独立部署和智能视频编辑支持进一步提升了项目的实用性，结合桌面客户端与容器化部署，项目可在多种场景下高效落地，支持多语言环境下的视频制作工作流，特别适合大模型驱动的智能视频创作应用。项目采用"API 层—服务层—工具层—自动化层"的分层设计，配合模板与草稿缓存机制，形成可复用的草稿基座与渲染管线。将输入的字符串转换为列表格式，主要用于处理单个字符串内容的包装。

2026-06-07 17:38:04 250

原创【开源剪映小助手】架构设计

本项目“capcut-mate”是一个面向剪映（CapCut）的自动化辅助系统，提供草稿管理、媒体素材处理、特效与字幕集成、以及视频导出能力。系统采用前后端分离策略：后端为基于 FastAPI 的 Web API，前端为 Electron 桌面应用，二者通过 IPC 和 HTTP 协议进行交互；capcut-mate 项目通过清晰的分层架构与前后端分离策略，实现了对剪映的自动化控制与 API 服务。容器化部署简化了运维与扩展。"调用electronService方法""HTTP请求后端API"

2026-06-06 21:50:12 244

原创【开源剪映小助手】技术栈概览

本项目为 CapCut Mate（剪映小助手），旨在提供一套完整的视频草稿自动化处理能力，包括草稿下载、素材管理、草稿生成与导出、以及桌面客户端交互。技术栈围绕 Python 后端（FastAPI + Uvicorn）、前端（React + Vite + Electron）、以及自动化控制（uiautomation）构建，同时提供容器化部署能力。

2026-06-05 20:07:21 376

原创【开源剪映小助手】核心功能特性

capcut-mate 是一个面向 CapCut（剪映）的自动化脚本与 API 平台，提供草稿管理、媒体处理、编辑效果系统与视频生成流程的完整能力。通过标准化的 REST API，用户可以快速创建草稿、批量添加视频/音频/图片/字幕/特效，以及异步生成视频。项目采用 FastAPI 提供接口，结合本地草稿缓存与剪映自动化控制，实现从“素材装配”到“云端渲染”的端到端工作流。

2026-06-04 20:31:16 232

原创【剪映小助手】草稿管理接口

本文档详细介绍剪映草稿管理的核心API接口，包括创建草稿、保存草稿、获取草稿文件列表三个基础功能。文档涵盖每个接口的HTTP方法、URL路径、请求参数、响应格式、错误处理等关键信息，帮助开发者快速集成草稿管理系统。

2026-06-03 19:42:34 228

原创【剪映小助手】音频处理接口

批量添加音频到剪映草稿的接口 /v1/add_audios，包括请求参数、音频信息数据结构、时间线布局、音量控制与音频效果应用音频时长获取接口 /v1/get_audio_duration 的使用方法与响应格式文档提供最佳实践建议，包括音频同步、多轨混合与音频效果处理策略，并给出常见问题排查方法。

2026-06-02 21:21:43 203

原创【剪映小助手】图片处理接口

本文档介绍剪映草稿图片处理接口，重点说明接口的图片添加功能。该接口用于向现有剪映草稿中添加图片素材，支持透明度、缩放和位置调整。图片可用于增强视频视觉效果，如背景图、水印、装饰图等。接口基于剪映草稿系统，通过 API 实现图片素材的批量添加和管理。系统支持多种图片动画效果，包括入场、出场和循环动画，以及转场效果配置。参数名类型必填默认值说明draft_urlstring✅目标草稿的完整URLstring✅图片信息数组的JSON字符串alphanumber❌1.0。

2026-06-01 19:23:33 184

原创【剪映小助手】贴纸处理接口

v1/add_sticker：贴纸添加接口，支持在指定时间段内向剪映草稿中添加贴纸，可配置缩放与位置偏移/v1/search_sticker：贴纸搜索接口，支持按关键词检索贴纸列表文档说明请求参数、时间线定位机制、缩放与位置配置、层级关系与渲染顺序、透明度与动画效果的应用方式，并提供贴纸 ID 获取、贴纸预览与效果配置的示例与最佳实践。

2026-05-29 18:05:04 174

原创【剪映小助手】视频处理接口

视频处理接口是 CapCut Mate 项目的核心功能模块，用于向剪映草稿中批量添加视频素材。该接口支持多个视频的批量处理，包括时间范围控制、透明度调整、遮罩效果、转场动画、音量控制、缩放变换等高级功能。重要更新：新增场景时间线功能，支持基于场景时长自动计算视频播放速度，为视频变速提供智能化解决方案。通过统一的 API 接口，开发者可以轻松将视频素材集成到剪映项目中，实现丰富的视频编辑功能，包括精确的速度控制和时间线同步。视频处理接口的核心是组件描述关键特性请求参数视频添加的输入参数。

2026-05-27 20:26:41 384

原创【剪映小助手】媒体处理接口

CapCut Mate 是基于 FastAPI 的媒体处理接口服务，用于与剪映（CapCut）集成，提供媒体素材添加和处理能力。系统支持视频、音频、图片、贴纸等多种媒体类型的批量处理，包含时间轴管理和轨道控制系统。本项目为开发者提供标准化 API 接口，可将各种媒体素材集成到剪映项目中，实现自动化内容创作和视频编辑流程。请求参数draft_url: 草稿 URL（必需）: 视频信息数组（JSON 字符串，必需）alpha: 透明度（0-1，默认 1.0）

2026-05-26 20:52:10 423

原创【剪映小助手】音频处理工具接口

音频处理工具接口是一个基于FastAPI构建的RESTful API服务，专门用于获取音频文件的时长信息。该接口支持多种音频格式，包括MP3、WAV、M4A等常见音频格式，为视频制作流程提供精确的音频时长数据。该服务的核心功能是通过HTTP接口接收音频文件URL，下载并解析音频文件的元数据，然后返回以微秒为单位的音频时长。这对于视频编辑、时间线规划和媒体资产管理具有重要意义。参数名类型必填描述示例mp3_urlHttpUrl是音频文件URL，支持mp3、wav、m4a等常见音频格式。

2026-05-25 20:52:18 369

原创【剪映小助手】贴纸搜索接口

贴纸搜索接口是 CapCut Mate 视频编辑工具的重要组成部分，用于根据用户提供的关键词搜索相关的贴纸素材。该接口支持在视频制作流程中快速定位和应用合适的贴纸效果，提升视频创作效率。该接口采用 RESTful API 设计，基于 FastAPI 框架构建，支持实时搜索、智能过滤和结果排序等功能。当前实现基于本地贴纸配置文件进行搜索，未来可扩展为支持外部贴纸库和高级搜索算法。端点方法: POST功能: 根据关键词搜索贴纸素材。

2026-05-24 18:33:56 379

原创【剪映小助手】数据转换工具接口

openapi/capcut-mate/v1/str_list_to_objs：字符串列表转对象列表/openapi/capcut-mate/v1/str_to_list：字符串转列表/openapi/capcut-mate/v1/objs_to_str_list：对象列表转字符串列表文档从架构设计、数据模型、处理流程、错误处理、性能优化与最佳实践等维度进行系统阐述，并提供可视化图示帮助理解。

2026-05-23 09:07:20 291

原创【剪映小助手】时间线计算接口

时间线计算接口是 CapCut Mate 视频编辑自动化平台的核心功能模块，负责为视频剪辑流程提供精确的时间轴管理能力。/timelines和，分别处理基于固定时长分配和基于音频时长适配的时间线生成。这些接口在视频剪辑流程中发挥着至关重要的作用，能够智能地将总时长分割为多个时间段，支持平均分配和随机分配两种模式，并能够根据音频文件的实际时长进行精确的时间线适配。通过这些接口，开发者可以轻松实现视频片段的自动对齐、音频与视频的同步处理以及复杂剪辑场景的时间管理。

2026-05-19 09:37:02 393

原创【剪映小助手】链接提取接口

本接口用于从输入内容中提取链接信息，当前版本实现为“多值返回变成单值返回”的直通逻辑，即直接返回输入内容，不做额外处理。接口遵循统一的请求/响应模型与错误处理机制，便于在内容处理流程中作为上游数据清洗与标准化环节使用。接口信息方法：POST路径：/openapi/capcut-mate/v1/get_url请求参数output：字符串，必填响应字段output：字符串错误码400：参数校验失败（如缺少 output）500：内部错误（未知异常）

2026-05-18 09:07:18 346

原创【剪映小助手】辅助工具接口

辅助工具接口是 CapCut Mate 项目的核心功能模块，专注于提供基础的实用工具接口。链接提取：从输入内容中提取链接信息，支持多值转单值返回贴纸搜索：基于关键词的贴纸库检索和智能推荐数据转换：多种数据格式之间的转换和批量处理能力这些基础工具接口为视频制作流程提供了简洁高效的自动化支持，特别适用于内容创作者的日常素材管理和处理需求。get_url接口用于从输入内容中提取链接信息，将多值返回转换为单值返回。该接口虽然看似简单，但在数据处理流程中发挥着重要作用。

2026-05-17 10:23:53 370

原创【剪映小助手】字幕信息生成接口

字幕信息生成接口（/caption_infos）是CapCut Mate项目中的一个核心API端点，专门用于根据文本内容和时间线生成字幕信息。该接口支持多种字幕样式配置、关键词高亮、入场出场动画以及转场效果设置。新增智能参数修剪和优雅降级机制，当输入参数长度不匹配时，系统会自动以最短长度为准进行处理，而不是直接抛出错误。根据文本列表和时间线数组生成字幕信息支持字体大小、颜色等样式定制提供关键词高亮功能支持入场、循环、出场动画效果配置转场效果和持续时间处理多字幕场景。

2026-05-16 10:27:19 365

原创【剪映小助手】音频信息生成接口

音频信息生成接口（/audio_infos）是CapCut Mate项目中的一个核心API端点，用于根据音频URL和时间线配置生成音频信息。该接口支持批量音频处理、音效设置和音量控制，为视频编辑流程提供完整的音频管理能力。将音频URL与对应的时间线配置进行关联支持音频效果的统一应用提供音量控制功能返回标准化的JSON格式音频信息智能参数修剪：当输入数组长度不匹配时自动截取到最短长度并记录警告日志。

2026-05-15 10:33:23 370

原创【开源剪映小助手】图片信息生成接口

图片信息生成接口（/v1/imgs_infos）是一个用于根据图片URL和时间线生成图片信息的API接口。该接口支持为多张图片设置不同的显示参数、入场出场动画、循环动画和转场效果，是剪映草稿制作流程中的重要组成部分。新版本引入了智能参数修剪和优雅降级机制，当输入参数长度不匹配时会自动处理而不是直接抛出异常。将图片URL与时间线信息进行智能匹配为每张图片生成独立的显示配置支持多动画类型和动画参数配置提供灵活的图片轨道管理能力自动处理参数长度不匹配的情况。

2026-05-14 14:42:04 387

原创突发！速推剪映小助手下架，依赖第三方的工作流全崩了！

工具可以借，但核心能力不能依附；效率可以借力，但命运必须自己掌控。大半年的辛苦不该白费，反复搭建的工作流不该说断就断。切换到开源剪映小助手（capcut-mate），从此告别第三方插件的不确定性，核心能力不求人，工作流永不崩，所有努力都能沉淀为自己的底气。

2026-05-13 18:06:21 237

原创【开源剪映小助手】特效信息生成接口

特效信息生成接口（/effect_infos）是 CapCut Mate API 的核心功能模块之一，专门用于根据特效名称和时间线生成特效信息。该接口为视频编辑流程提供了灵活的特效管理能力，支持多种特效类型包括滤镜效果、转场效果和创意特效。该接口现已具备智能参数修剪和优雅降级机制，能够在参数长度不匹配时自动调整并继续处理，而不是直接抛出错误。智能参数修剪：自动处理长度不匹配的参数，以最短长度为准优雅降级机制：在参数不匹配时记录警告并继续执行灵活的特效配置：支持多种特效类型的动态配置精确的时间控制。

2026-05-12 08:41:46 357

原创【开源剪映小助手】视频信息生成接口

视频信息生成接口（/video_infos）是CapCut Mate项目中的一个重要API端点，专门用于根据视频URL和时间线参数生成视频信息JSON数据。该接口为视频编辑工作流提供了基础的数据准备能力，支持多视频拼接、视频效果应用和轨道管理。将视频URL与时间线参数关联，生成标准化的视频信息结构支持视频轨道参数配置（宽度、高度）遮罩设置（圆形、矩形、爱心、星形等）转场效果配置音量控制参数多视频批量处理能力增强的容错处理。

2026-05-11 09:54:04 240

原创【开源剪映小助手】媒体信息生成接口

v1/audio_infos：根据音频 URL 和时间线生成音频信息/v1/imgs_infos：根据图片 URL 和时间线生成图片信息/v1/video_infos：根据视频 URL 和时间线生成视频信息/v1/caption_infos：根据文本和时间线生成字幕信息/v1/effect_infos：根据特效名称和时间线生成特效信息/v1/keyframes_infos：根据关键帧类型、位置比例和值生成关键帧信息。

2026-05-10 09:07:58 435

原创【开源剪映小助手】关键帧信息生成接口

关键帧信息生成接口（/keyframes_infos）是CapCut Mate项目中的一个重要API端点，专门用于根据关键帧类型、位置比例和数值生成关键帧信息。该接口支持多种动画属性类型，包括位置、缩放、旋转、透明度等，为视频编辑提供强大的动画控制能力。该接口的核心功能是将用户提供的关键帧参数转换为剪映草稿系统可识别的关键帧数据格式，支持线性插值算法，并提供完整的错误处理和日志记录机制。

2026-05-09 09:25:05 367

原创【开源剪映小助手】遮罩效果接口

本文档是遮罩效果接口的详细 API 文档，涵盖遮罩的创建与应用流程，包括遮罩形状定义、几何参数配置、羽化与反相效果；解释遮罩坐标系统、尺寸调整、旋转角度与圆角处理；说明遮罩的实时预览、多遮罩叠加与遮罩与视频内容的合成规则；并提供最佳实践、性能建议、常见问题与调试方法。接口路径：POST /openapi/capcut-mate/v1/add_masks请求体字段draft_url：草稿 URL（必填）segment_ids：片段 ID 数组（必填）name：遮罩类型名称（可选，默认"线性"）

2026-05-08 19:54:01 368

原创【开源剪映小助手】文字样式接口

文字样式接口是 CapCut Mate 剪映自动化工具的核心功能模块，专门用于为文本内容创建富文本样式。该接口支持关键词高亮、颜色配置、字体大小调整和文本装饰效果，为视频编辑软件提供完整的文字样式处理能力。关键词高亮处理：支持多关键词识别和高亮显示字体大小继承：智能继承和应用字体大小设置样式链式组合：支持复杂样式的组合和叠加参数化配置：灵活的参数化样式配置选项动态样式生成：实时生成和应用样式效果。

2026-05-07 10:23:47 353

原创【开源剪映小助手】特效应用接口

特效应用接口是剪映草稿管理系统的重要组成部分，负责向现有草稿中添加各种视频特效。该接口支持多种特效类型，包括边框特效、滤镜特效、动态特效、过渡效果等，为视频编辑提供了强大的视觉效果增强能力。系统现已支持更丰富的特效类型，包括过渡效果如"淡入"、"淡出"以及各种颜色滤镜效果。同时需要注意的是，某些特效在预览模式下可能不可见，但在最终视频生成时会正常应用。本接口采用RESTful API设计，通过HTTP POST请求接收特效配置参数，在服务端完成特效解析、验证和应用，最终返回更新后的草稿信息。

2026-05-06 07:46:37 400

原创【开源剪映小助手】滤镜系统文档

CapCut Mate 是一个基于 Python 的剪映草稿处理系统，专门用于自动化视频编辑工作流。滤镜系统是该系统的核心功能之一，允许用户向视频草稿中添加各种视觉滤镜效果，包括复古、黑白、电影感等多种风格的滤镜。该系统提供了完整的滤镜管理能力，包括滤镜元数据定义、滤镜片段创建、轨道管理和API接口等。通过统一的API接口，开发者可以轻松地在视频编辑流程中集成滤镜效果。: 添加滤镜的请求参数模型FilterItem: 单个滤镜信息的数据结构: 添加滤镜的响应参数模型: 滤镜信息生成的请求参数模型。

2026-05-05 09:34:18 375

原创【开源剪映小助手】关键帧动画接口

本文档面向关键帧动画接口的使用者与维护者，详细说明关键帧动画的创建原理、实现机制与API设计。关键帧类型与时间点设置数值归一化与插值策略动画曲线配置与导出在位置、缩放、旋转、透明度等属性上的应用编辑操作、插值模式与动画流畅度控制设计指南、性能优化与复杂动画实现方法调试工具与效果验证方法。

2026-05-04 08:34:05 354

原创【开源剪映小助手】编辑效果接口

编辑效果接口是CapCut Mate的核心功能模块，负责处理基础视频编辑效果。基于FastAPI框架实现，通过RESTful API提供服务，支持特效应用、遮罩效果、关键帧动画、文字样式等编辑功能。系统聚焦核心编辑效果，提供简洁高效的API，方便开发者快速集成视频编辑能力。所有接口使用统一响应格式，包含完整的错误处理和参数验证机制。功能聚焦：专注于核心编辑效果功能，避免功能冗余接口简洁：提供最少必要的API端点，降低学习成本类型安全：使用Pydantic模型确保参数验证和类型安全错误处理。

2026-05-03 16:22:58 397

空空如也

空空如也