SAVE_DRAFTAPI接口文档接口信息展开代码语言:TXTAI代码解释POST/openapi/capcut-mate/v1/save_draft功能描述保存剪映草稿。
快速开始目录简介项目结构核心组件架构总览详细组件分析依赖分析性能注意事项故障排查指南结论附录简介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界面操作支持✓✗(占位符功能)✅剪映应用控制
获取草稿文件列表。该接口用于获取指定草稿ID对应的所有文件列表,可以查看草稿中包含的素材文件、配置文件等信息。通常用于草稿内容的预览、文件管理或状态检查。
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
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代码解释#基础安装(无剪映自动化功能
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对象存储集成配置
除了通过公网IP访问HAI实例的6889端口连接ChatBot使用DeepSeek外,我们也可以通过访问HAI实例中运行DeepSeek模型的Ollama API,将运行在HAI中的DeepSeek接入到本地电脑调用
重点涵盖以下方面:云渲染环境的技术架构与控制流腾讯云COS对象存储的配置与使用流程剪映草稿保存路径的配置方法云渲染必需的环境变量设置监控、日志收集与故障排查方法不同云服务商的兼容性说明与迁移指南项目结构该项目采用模块化设计 架构概览云渲染环境的核心流程包括:客户端请求进入API层,经中间件处理后调用服务层逻辑;服务层根据需求下载剪映草稿、处理媒体资源,并将产物上传至COS;最终通过统一响应格式返回结果。 使用robocopy触发剪映目录扫描,使其识别新文件。错误处理网络请求失败、IO错误、路径解析异常均有相应处理与日志记录。 剪映草稿保存路径配置本地路径DRAFT_SAVE_PATH指定剪映草稿保存位置(Windows路径示例)。 容器挂载docker-compose.yaml将宿主机目录挂载到/app/output,供剪映识别与访问。云渲染必需环境变量DRAFT_URL:草稿下载地址。
>文件下载/目录选择/日志/历史"]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集合。性能:对大文件使用流式下载与重试机制,限制日志与历史记录数量。
剪映是当下比较火的一款手机视频剪辑工具,由抖音官方推出,可用于手机短视频的剪辑制作,拥有强大的多轨编辑能力。 观察剪映的视频剪辑页面,可见主要有时间轴、视频轨道、时间游标和预览窗口四部分组成。时间轴用于展示当前的时间长度和时间刻度,通过缩放手势可以改变最小刻度值,拖动可以对音视频进行seek。 至此,高仿剪映多轨编辑View实现完成。 override fun dispatchDraw(canvas: Canvas?) 总结 以上只是对剪映主要逻辑的实现,实际还缺失很多比较细微的功能,比如显示视频截图、删除移动轨道等,并且实际效果与剪映还有一些差异。 支持剪映没有的多视频轨道图层移动和缩放,可以任意摆放各个视频轨道的位置! 支持常规的音视频Seek、暂停与播放等。 以上源码都开源在hwvc项目
提交视频生成任务。该接口采用异步处理模式,立即返回任务提交状态,视频生成在后台进行。支持任务排队,确保系统稳定性。
该接口用于在指定的时间段内添加图片素材到剪映草稿中,支持图片的透明度、缩放和位置调整。图片可以用于增强视频的视觉效果,如背景图、水印、装饰图等。
获取图片出入场动画列表,返回所有支持的且满足条件的图片出入场动画。支持根据动画类型(入场、出场、循环)和会员模式(所有、VIP、免费)进行筛选。
目录扫描功能目录扫描功能概述目录扫描功能是CapCutMate项目中的核心特性之一,主要用于实现剪映草稿文件的自动发现和管理。 该功能通过模拟文件系统变更事件,使剪映应用程序能够自动检测到新下载的草稿文件,而无需重启应用程序。 目录扫描器]endsubgraph"系统集成层"Robocopy[Windows:robocopy]Rsync[macOS:rsync]FileSystem[文件系统监控]endsubgraph"后端服务层"API SyncDir["同步目录结构"]CopyDir-->TriggerEvent["触发文件系统事件"]SyncDir-->TriggerEventTriggerEvent-->UpdateJianying["更新剪映草稿列表 常见问题及解决方案问题类型症状描述解决方案扫描失败目录扫描无响应检查目标目录权限Windows错误robocopy返回码>=8检查磁盘空间和文件锁定macOS错误rsync执行失败检查文件系统权限草稿未显示新下载草稿不在剪映中手动重启剪映应用程序
内容覆盖剪映自动化失败、API调用异常、Docker部署问题、性能问题排查、内存泄漏检测与系统兼容性处理,并提供日志分析技巧与问题定位步骤,帮助用户自助解决大部分问题。 后端负责API路由、中间件、日志与剪映草稿下载;桌面客户端负责草稿下载、日志与历史记录管理;Dockerfile与docker-compose.yaml提供容器化部署。 :解析草稿URL、获取文件列表、逐个下载并写入本地,必要时更新JSON路径,最后通过robocopy触发剪映目录扫描。 ,避免剪映未及时发现新增文件。 参考路径:desktop-client/main.js、desktop-client/main.js二、剪映自动化失败症状:草稿下载成功但剪映未识别排查要点:确认触发目录扫描成功;检查robocopy返回码
in"、"out"、"loop"中的一个动画模式:mode参数只能是0、1、2中的一个响应格式:与旧版本不同,当前版本直接返回对象数组而非JSON字符串数据来源:当前使用模拟数据,生产环境中应从数据库或API
为文本创建富文本样式,支持关键词高亮、颜色设置、字体大小调整等功能。该接口可以将普通文本转换为包含样式信息的富文本格式,实现关键词突出显示、多样化的文本展示效果。
的桌面客户端位于desktop-client目录,采用“主进程+预加载桥接+React前端”的典型Electron架构:主进程负责窗口生命周期、系统集成与IPC注册预加载脚本通过contextBridge暴露受控API electron-builder-green.config.js分别定义了标准安装包与绿色便携包的打包规则主进程与窗口管理main.js负责窗口创建、开发/生产模式切换、异常捕获与IPC初始化预加载与API 暴露preload.js通过contextBridge暴露受限API,供React前端调用NodeAPI业务逻辑nodeapi/ipcHandlers.js注册IPC处理函数,连接下载、日志、配置、历史记录等功能 assets/entitlements.mac.plist配置沙箱与文件夹访问权限前端服务封装web/src/services/electronService.js提供浏览器与Electron环境的双态API 暴露通过contextBridge.exposeInMainWorld暴露受限API,包括文件保存、草稿下载、日志、消息框、外部链接、配置、历史记录等渲染进程通过window.electronAPI调用
Electron服务封装:统一浏览器与Electron环境下的API调用差异。 切换页码|ChangePage["更新当前页并渲染"]Interact-->|无|End(["结束"])Copy-->EndChangePage-->Render配置中心页面(路径设置)功能:读取并展示剪映草稿保存路径
该接口用于在指定的时间段内添加贴纸素材到剪映草稿中,支持贴纸的缩放和位置调整。贴纸可以用于增强视频的视觉效果,如表情、装饰、文字等。 单位为像素正值向下移动负值向上移动以画布中心为原点实际存储时会转换为半画布高单位(假设画布高度1080,即除以540)贴纸ID说明sticker_id:贴纸的唯一标识符格式:通常为数字字符串示例:"7326810673609018675"获取方式:通过剪映贴纸库或相关 API获取响应格式成功响应(200)展开代码语言:JSONAI代码解释{"draft_url":"https://capcut-mate.jcaigc.cn/openapi/capcut-mate/v1