- 综合排序
- 最热优先
- 最新优先
【剪映小助手】保存剪映草稿
SAVE_DRAFTAPI接口文档接口信息展开代码语言：TXTAI代码解释POST/openapi/capcut-mate/v1/save_draft功能描述保存剪映草稿。
68910编辑于 2025-12-06【开源剪映小助手】API 接口文档
API接口文档目录简介项目结构核心组件架构概览详细组件分析双语文档依赖关系分析性能考虑故障排除指南小结简介CapCutMate提供RESTfulAPI，用于自动化剪映草稿管理与视频生成。 采用三层架构：表现层：FastAPI路由与请求/响应模型业务层：服务层封装具体业务逻辑，如草稿创建、媒体添加、渲染导出等控制层：与剪映交互，执行窗口激活、素材导入与渲染操作展开代码语言：TXTAI代码解释 /响应模型
src/schemas/*.py"]D["文档与OpenAPI"]endsubgraph"业务层"S["服务层
service.*"]endsubgraph"控制层"J["剪映控制器 依赖关系分析组件耦合路由模块依赖请求/响应模型与服务层；服务层依赖剪映控制器进行底层操作文档系统与路由模块相互独立，通过接口定义进行关联外部依赖FastAPI提供路由与请求/响应模型校验；剪映控制器负责窗口与素材交互文档系统依赖 提升整体效率时间线计算使用时间线工具提前规划素材分布，避免运行时动态计算带来的延迟资源复用合理设置透明度与缩放比例，减少不必要的渲染开销异步渲染视频生成采用异步任务，建议使用查询状态接口轮询进度故障排除指南无法连接剪映确认剪映已安装并可被系统识别96910编辑于 2026-04-28- 来自专栏剪映小助手
【剪映小助手】快速开始
快速开始目录简介项目结构核心组件架构总览详细组件分析依赖分析性能注意事项故障排查指南结论附录简介capcut-mate是一个面向剪映（CapCut）的自动化辅助服务，提供草稿创建、媒体素材添加、字幕与特效处理 新增的响应中间件负责统一处理API响应格式和语言切换。 附录环境要求Python：>=3.11Node.js：用于桌面客户端（随Electron依赖）Windows/macOS：桌面客户端与剪映集成依赖新增网络浏览器：支持Accept-Language请求头的语言检测功能安装与运行步骤方式一 文件中设置草稿下载URL、下载URL前缀、提示URL等方式三：桌面客户端使用1)安装依赖在桌面客户端根目录与web子目录分别安装依赖2)启动桌面应用使用Electron启动主进程3)配置草稿路径在"配置中心"页面选择剪映草稿保存路径 test_cross_platform.py验证功能导入跨平台功能对比更新详细的跨平台功能对比表功能特性Windows平台Linux平台✅完整的视频导出自动化功能✓✗（需要手动导出）✅UI界面操作支持✓✗（占位符功能）✅剪映应用控制
79810编辑于 2026-03-16 - 来自专栏剪映小助手
【剪映小助手】获取草稿文件列表
获取草稿文件列表。该接口用于获取指定草稿ID对应的所有文件列表，可以查看草稿中包含的素材文件、配置文件等信息。通常用于草稿内容的预览、文件管理或状态检查。
70010编辑于 2025-12-06 【简创AIGC】创建剪映草稿
CREATE_DRAFT API 接口文档接口信息POST /openapi/capcut-mate/v1/create_draft功能描述创建剪映草稿。 该接口用于创建一个新的剪映草稿项目，可以自定义视频的宽度和高度。创建成功后会返回草稿URL和帮助文档URL，为后续的视频编辑操作提供基础。 requestsfrom typing import Optional, Dictclass DraftCreator: def __init__(self, base_url: str = "https://api.assets.jcaigc.cn
71310编辑于 2025-09-30【剪映小助手】贴纸搜索接口
项目结构贴纸搜索功能在项目中的组织结构如下：展开代码语言：TXTAI代码解释graphTBsubgraph"API层"Router[路由层
src/router/v1.py]endsubgraph SchemaService-->ConfigService-->StickerDataService-->LoggerQueryTool-->StickerDataTest-->Service核心组件API Service[服务模块]Schema[数据模型]Config[配置管理]Logger[日志系统]endsubgraph"数据源"StickerFile[贴纸配置文件]ExternalAPI[外部贴纸API 当前实现具有以下特点：优势简单易用:API设计直观，易于集成快速实现:基于本地配置文件，部署简单可扩展性强:支持多种优化策略和扩展方案测试完备:包含基本功能测试用例改进建议增强搜索算法:实现全文搜索和智能匹配引入缓存系统9410编辑于 2026-05-24- 来自专栏剪映小助手
【开源剪映小助手】Docker 部署
capcut-mate容器]-->B[FastAPI应用]B-->C[草稿下载服务]C-->D[文件系统]E[Nginx服务器]-->F[静态文件服务]F-->G[输出目录文件]endsubgraph"外部服务"H[剪映客户端 TXTAI代码解释flowchartTDA[接收草稿URL]-->B[提取草稿ID]B-->C[准备目标目录]C-->D[获取文件列表]D-->E[下载所有文件]E-->F[更新JSON路径]F-->G[触发剪映扫描 Windows平台:完整功能，包括剪映自动化导出可选安装:Windows用户可通过pipinstallcapcut-mate[windows]获取完整功能性能考虑容器资源优化内存和CPU限制内存限制:2GB docs.jcaigc.cn跨平台兼容性问题Windows依赖缺失症状:在非Windows平台运行时出现ImportError解决方案:展开代码语言：BashAI代码解释#非Windows平台正常运行（无剪映自动化功能 /localtime:/etc/localtime:ro-/etc/timezone:/etc/timezone:ro跨平台安装指南非Windows平台展开代码语言：BashAI代码解释#基础安装（无剪映自动化功能
35110编辑于 2026-04-08 【开源剪映小助手】字幕接口
项目结构项目采用清晰的分层架构设计：展开代码语言：TXTAI代码解释graphTBsubgraph"API层"Router[路由层]Schema[模式定义]endsubgraph"服务层"Service 轴位置偏移字幕信息生成接口字幕信息生成接口提供自动化字幕信息生成功能：展开代码语言：TXTAI代码解释sequenceDiagramparticipantClientas"客户端"participantAPIas"API 接口"participantServiceas"服务层"participantGeneratoras"字幕生成器"Client->>API:POST/v1/caption_infosAPI->>Service :返回JSON字符串API-->>Client:字幕信息响应架构概览系统采用分层架构设计，确保各层职责清晰分离：展开代码语言：TXTAI代码解释graphTDsubgraph"表现层"WebUI[Web 界面]API[RESTfulAPI]endsubgraph"应用层"Router[路由处理器]Validator[参数验证器]Formatter[数据格式化器]endsubgraph"业务层"CaptionsService
18110编辑于 2026-05-02【开源剪映小助手】项目介绍
项目介绍目录引言项目发展历程核心价值主张设计理念与创新点主要应用场景目标用户群体项目资源工作流示例项目结构核心组件架构总览详细组件分析依赖关系分析性能考量故障排查指南结论引言CapCutMateAPI是一个完全开源免费的剪映自动化助手 该项目专注于为大模型赋能基础视频编辑能力，提供开箱即用的视频编辑技能，并已完全自动化了剪映核心功能工作流。它可以直接连接大模型，实现多样化的智能视频编辑，让普通用户能够快速制作专业级的视频作品。 桌面客户端（草稿下载与配置）下载页面功能：输入草稿地址（支持多行），自动解析draft_id并获取文件列表过滤匹配的文件，调用ElectronAPI保存到本地实时显示下载日志，支持清空配置中心功能：设置剪映草稿保存路径 ：检查剪映是否已启动且窗口可见，确认自动化控件匹配条件导出超时：检查草稿大小与素材质量，适当降低导出分辨率/帧率草稿下载失败：确认草稿地址有效且包含draft_id参数，检查网络连通性与目标路径权限权限问题处理 ：检查Docker配置和环境变量设置结论CapCutMateAPI通过标准化的OpenAPI与桌面客户端，将剪映的草稿创建、素材注入与视频生成流程自动化，显著降低了内容创作者与自动化团队的操作门槛。
39910编辑于 2026-04-27【开源剪映小助手】特效应用接口
特效应用接口目录简介项目结构核心组件架构概览详细组件分析依赖关系分析性能考虑故障排除指南结论简介特效应用接口是剪映草稿管理系统的重要组成部分，负责向现有草稿中添加各种视频特效。 项目结构剪映特效应用接口基于模块化架构设计，主要分为以下几个层次：展开代码语言：TXTAI代码解释graphTBsubgraph"API层"Router[路由层]Schema[数据模型层]endsubgraph EffectMetaEffectMeta-->SceneEffectEffectMeta-->CharacterEffectFilterMeta-->SegmentTransitionMeta-->Segment核心组件API ：预览限制:某些特效在预览模式下可能不可见，但在最终视频生成时会正常应用效果叠加:系统支持多个特效在同一时间段叠加应用兼容性:不同特效类型之间可能存在兼容性问题，建议测试后再批量应用结论特效应用接口为剪映草稿管理系统提供了完整的特效添加功能 ：丰富的特效类型:现已支持500+种特效，包括过渡效果、滤镜效果、场景特效等预览限制说明:明确告知用户特效在预览中的可见性限制增强的参数控制:提供更精细的特效参数调节能力接口的主要优势：易用性:简洁的API
15710编辑于 2026-05-06- 来自专栏剪映小助手
【开源剪映小助手】媒体处理功能
媒体处理功能目录简介项目结构核心组件架构概览详细组件分析依赖关系分析性能考虑故障排除指南结论简介CapCutMate是一个基于剪映（CapCut）的专业视频编辑辅助工具，提供完整的媒体处理功能。 本系统采用现代化的架构设计，通过FastAPI提供RESTfulAPI接口，结合剪映自动化控制技术，实现了从媒体文件解析、格式转换、时长计算到轨道分配的完整处理流程。 "JYController[剪映控制器]Segment[片段管理]Track[轨道管理]endRouter-->SchemaRouter-->VideoSvcRouter-->AudioSvcRouter UI自动化技术与剪映应用进行交互：剪映状态管理展开代码语言：TXTAI代码解释stateDiagram-v2[*]-->home:主页home-->edit:进入编辑页edit-->pre_export 系统具备以下核心优势：模块化设计：清晰的分层架构便于维护和扩展自动化程度高：通过剪映自动化实现无缝集成性能优异：异步处理和缓存机制确保高效运行错误处理完善：全面的异常处理和恢复机制API友好：标准化的RESTful
18910编辑于 2026-04-19 【开源剪映小助手】滤镜系统文档
滤镜系统文档目录简介项目结构核心组件架构概览详细组件分析依赖关系分析性能考虑故障排除指南结论简介CapCutMate是一个基于Python的剪映草稿处理系统，专门用于自动化视频编辑工作流。 该系统提供了完整的滤镜管理能力，包括滤镜元数据定义、滤镜片段创建、轨道管理和API接口等。通过统一的API接口，开发者可以轻松地在视频编辑流程中集成滤镜效果。 项目结构滤镜系统主要分布在以下几个核心模块中：展开代码语言：TXTAI代码解释graphTBsubgraph"API层"Router[路由层]Schemas[数据模型]endsubgraph"服务层"AddFilters SaveDraft["保存草稿"]SaveDraft-->ReturnResult["返回处理结果"]Error-->End([结束])ReturnResult-->EndAPI接口设计系统提供了两个主要的API 通过精心设计的分层架构、完善的元数据管理和强大的API接口，为开发者提供了灵活高效的滤镜处理能力。
18110编辑于 2026-05-05【开源剪映小助手】遮罩效果接口
遮罩效果接口目录简介项目结构核心组件架构总览详细组件分析依赖关系分析性能考量故障排查指南结论附录简介本文档是遮罩效果接口的详细API文档，涵盖遮罩的创建与应用流程，包括遮罩形状定义、几何参数配置、羽化与反相效果
10010编辑于 2026-05-08【开源剪映小助手】代码结构说明
代码结构说明目录简介项目结构核心组件架构总览详细组件分析依赖关系分析性能考量故障排查指南结论附录简介本项目为CapCutMate（剪映助手）的后端与桌面客户端一体化方案，采用“Python后端+Electron 项目结构项目采用模块化分层组织：根目录：后端入口、配置、Docker支持、测试与文档src：后端核心代码，包含路由、服务、中间件、工具与剪映草稿模型desktop-client：Electron桌面应用 ，包含主进程、预加载脚本、React前端与NodeAPItemplate：剪映草稿模板资源tests：后端接口与业务逻辑测试docs：功能使用文档展开代码语言：TXTAI代码解释graphTBsubgraph ，每个路由对应一个服务方法中间件准备中间件：确保草稿与临时目录存在统一响应中间件：标准化成功/失败响应与异常处理服务层聚合业务逻辑，封装对剪映草稿模型与工具的调用示例：创建草稿、添加媒体、生成时间线、导出视频等配置定义项目根目录 setupIpcHandlers权限错误：主进程对未捕获异常进行记录并在macOS上弹窗提示浏览器环境：electronService在浏览器环境使用模拟实现，部分功能不可用结论本项目通过清晰的分层架构与前后端分离设计，实现了剪映草稿的自动化处理与桌面应用的便捷使用
15700编辑于 2026-04-23【开源剪映小助手】开发环境搭建
：TXTAI代码解释sequenceDiagramparticipantClientas"桌面客户端"participantAPIas"FastAPI服务"participantJianyingas"剪映控制 "participantCOSas"腾讯云存储"Client->>API:HTTP请求API->>API:验证请求API->>Jianying:控制剪映窗口Jianying-->>API:导出状态API ->>COS:上传草稿COS-->>API:上传结果API-->>Client:响应数据详细组件分析后端服务配置FastAPI应用初始化后端服务使用FastAPI构建，包含完整的路由注册和中间件配置：展开代码语言
15410编辑于 2026-04-25【开源剪映小助手】配置与部署
DRAFT_DIR、TEMP_DIR、DRAFT_URL、DOWNLOAD_URL、TIP_URL、STICKER_CONFIG_PATH、TEMPLATE_DIR云渲染必需：DRAFT_SAVE_PATH（剪映草稿保存路径 生产环境编排（挂载输出目录、时区、环境变量、资源限制、重启策略）docker-compose.example.yaml：示例环境编排（生产环境参考配置）跨平台支持Windows平台：完整功能，包括UI自动化和剪映控制 CrossPlat["跨平台支持
pyJianYingDraft"]endsubgraph"外部系统"COS["腾讯云COS"]Nginx["静态资源服务
nginx"]Jianying["剪映导出流程 服务功能✅完整支持✅完整支持草稿管理✅支持✅支持素材处理✅支持✅支持视频自动导出✅支持❌不支持UI界面操作✅支持❌不支持剪映应用控制✅支持❌不支持CI/CD与自动化部署GitHubActions工作流项目使用 C.云渲染环境搭建与监控告警建议云渲染环境搭建安装并运行剪映专业版，确保可导出草稿配置DRAFT_SAVE_PATH指向剪映草稿目录配置ENABLE_APIKEY为true，接入积分服务COS对象存储集成配置38510编辑于 2026-04-09【剪映小助手】字幕信息生成接口
字幕信息生成接口目录简介项目结构核心组件架构概览详细组件分析依赖关系分析性能考虑故障排除指南结论附录简介字幕信息生成接口（/caption_infos）是CapCutMate项目中的一个核心API端点， 出场动画效果配置转场效果和持续时间处理多字幕场景智能参数修剪和优雅降级机制项目结构CapCutMate项目采用模块化架构设计，字幕信息生成功能分布在以下层次：展开代码语言：TXTAI代码解释graphTBsubgraph"API API规范端点：POST/v1/caption_infos请求头：Content-Type:application/json响应格式：JSON字符串，包含字幕信息数组状态码：200:请求成功400:参数错误
11110编辑于 2026-05-16- 来自专栏剪映小助手
【开源剪映小助手】IPC 通信机制
>文件下载/目录选择/日志/历史"]L["nodeapi/logger.js
日志输出"]endsubgraph"预加载脚本"P["preload.js
contextBridge暴露API 预加载脚本安全桥接：通过contextBridge.exposeInMainWorld将有限API暴露给渲染进程，避免直接暴露Node/Electron能力。 渲染进程依赖：electronService：统一API封装。react、react-toastify：UI与提示。axios：浏览器环境下的URL可达性检测。 结论capcut-mate的IPC通信机制遵循Electron最佳实践：主进程集中处理系统调用与文件操作，预加载脚本通过contextBridge暴露有限API，渲染进程通过统一的服务层进行调用。 安全性：始终启用上下文隔离与禁用Node集成，通过预加载脚本暴露最小API集合。性能：对大文件使用流式下载与重试机制，限制日志与历史记录数量。15810编辑于 2026-03-21 - 来自专栏剪映小助手
【开源剪映小助手】测试策略与实践
集成测试：test_*_api.py或test_api_version.py，如test_api_version.py。 服务层和API层导入：确保各层模块在跨平台环境下的可用性。工具层导入：验证工具函数和辅助模块的跨平台兼容性。平台特定功能：Windows平台的UI自动化和Linux平台的占位符功能。 剪映控制器可用性：根据平台特性检测功能可用性。 结论本测试策略以pytest为核心，结合单元测试、集成测试、手动测试与专项测试，覆盖API、服务层、工具函数与跨平台功能的关键路径。 附录测试文件命名规范单元测试：test_*.py集成测试：test_*_api.py或test_api_version.py手动测试：manual_test_*.py专项测试：test_fix.py、testimprovement.py
19910编辑于 2026-04-21 【开源剪映小助手】调试与故障排除
Electron桌面客户端+React前端”的混合架构：后端：FastAPI提供OpenAPI路由，中间件负责请求准备与统一响应包装桌面客户端：Electron主进程创建窗口、注册IPC处理器；预加载脚本暴露受控API EndNon200-->End桌面客户端调试主进程：开发模式自动打开开发者工具，生产模式加载构建产物未捕获异常处理：记录错误并在macOS沙箱权限错误时弹窗提示预加载脚本：通过contextBridge暴露受控API middlewares/response.py、exceptions.py2.桌面客户端调试开发者工具现象：界面无响应或无法看到渲染进程日志排查：确认开发模式下已打开DevTools；检查预加载脚本是否正确暴露API 处理器返回；确认目标目录权限参考路径：desktop-client/nodeapi/ipcHandlers.js、desktop-client/nodeapi/logger.js5.自动化控制异常现象：剪映窗口未激活或导出状态异常排查 ：检查窗口激活逻辑与日志；确认剪映安装与路径配置参考路径：main.py6.常见问题与预防目录权限不足预防：启动前通过PrepareMiddleware创建目录；在macOS检查沙箱权限参考路径：src
15410编辑于 2026-04-24
腾讯云开发者
Copyright © 2013 - 2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有
深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 
粤公网安备44030502008569号
腾讯云计算（北京）有限责任公司 京ICP证150476号 | 京ICP备11018762号