- 综合排序
- 最热优先
- 最新优先
【剪映小助手】保存剪映草稿
SAVE_DRAFTAPI接口文档接口信息展开代码语言：TXTAI代码解释POST/openapi/capcut-mate/v1/save_draft功能描述保存剪映草稿。
54510编辑于 2025-12-06- 来自专栏剪映小助手
【剪映小助手】快速开始
快速开始目录简介项目结构核心组件架构总览详细组件分析依赖分析性能注意事项故障排查指南结论附录简介capcut-mate是一个面向剪映（CapCut）的自动化辅助服务，提供草稿创建、媒体素材添加、字幕与特效处理 附录环境要求Python：>=3.11Node.js：用于桌面客户端（随Electron依赖）Windows/macOS：桌面客户端与剪映集成依赖新增网络浏览器：支持Accept-Language请求头的语言检测功能安装与运行步骤方式一 文件中设置草稿下载URL、下载URL前缀、提示URL等方式三：桌面客户端使用1)安装依赖在桌面客户端根目录与web子目录分别安装依赖2)启动桌面应用使用Electron启动主进程3)配置草稿路径在"配置中心"页面选择剪映草稿保存路径 test_cross_platform.py验证功能导入跨平台功能对比更新详细的跨平台功能对比表功能特性Windows平台Linux平台✅完整的视频导出自动化功能✓✗（需要手动导出）✅UI界面操作支持✓✗（占位符功能）✅剪映应用控制
54710编辑于 2026-03-16 - 来自专栏剪映小助手
【剪映小助手】获取草稿文件列表
获取草稿文件列表。该接口用于获取指定草稿ID对应的所有文件列表，可以查看草稿中包含的素材文件、配置文件等信息。通常用于草稿内容的预览、文件管理或状态检查。
52310编辑于 2025-12-06 - 来自专栏剪映小助手
【开源剪映小助手】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代码解释#基础安装（无剪映自动化功能
22010编辑于 2026-04-08 【开源剪映小助手】配置与部署
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["剪映导出流程 port","8000"]功能差异对比功能Windows平台Linux平台API服务功能✅完整支持✅完整支持草稿管理✅支持✅支持素材处理✅支持✅支持视频自动导出✅支持❌不支持UI界面操作✅支持❌不支持剪映应用控制 C.云渲染环境搭建与监控告警建议云渲染环境搭建安装并运行剪映专业版，确保可导出草稿配置DRAFT_SAVE_PATH指向剪映草稿目录配置ENABLE_APIKEY为true，接入积分服务COS对象存储集成配置13610编辑于 2026-04-09- 来自专栏剪映小助手
【开源剪映小助手】IPC 通信机制
本文件面向 capcut-mate 桌面客户端的 IPC 通信机制，系统性阐述主进程与渲染进程之间的消息传递、预加载脚本的安全桥接、具体 IPC 处理程序的实现细节，以及通信协议设计、错误处理与性能优化的最佳实践。同时提供自定义 IPC 处理程序的开发指南，帮助开发者快速扩展功能。
10310编辑于 2026-03-21 - 来自专栏剪映小助手
【开源剪映小助手】 云渲染环境搭建
重点涵盖以下方面：云渲染环境的技术架构与控制流腾讯云COS对象存储的配置与使用流程剪映草稿保存路径的配置方法云渲染必需的环境变量设置监控、日志收集与故障排查方法不同云服务商的兼容性说明与迁移指南项目结构该项目采用模块化设计 架构概览云渲染环境的核心流程包括：客户端请求进入API层，经中间件处理后调用服务层逻辑；服务层根据需求下载剪映草稿、处理媒体资源，并将产物上传至COS；最终通过统一响应格式返回结果。 使用robocopy触发剪映目录扫描，使其识别新文件。错误处理网络请求失败、IO错误、路径解析异常均有相应处理与日志记录。 剪映草稿保存路径配置本地路径DRAFT_SAVE_PATH指定剪映草稿保存位置（Windows路径示例）。 容器挂载docker-compose.yaml将宿主机目录挂载到/app/output，供剪映识别与访问。云渲染必需环境变量DRAFT_URL：草稿下载地址。
1800编辑于 2026-04-14 - 来自专栏剪映小助手
【剪映小助手】向现有草稿中添加图片
该接口用于在指定的时间段内添加图片素材到剪映草稿中，支持图片的透明度、缩放和位置调整。图片可以用于增强视频的视觉效果，如背景图、水印、装饰图等。
34210编辑于 2025-12-06 - 来自专栏剪映小助手
【剪映小助手】获取图片出入场动画列表
获取图片出入场动画列表，返回所有支持的且满足条件的图片出入场动画。支持根据动画类型（入场、出场、循环）和会员模式（所有、VIP、免费）进行筛选。
28610编辑于 2025-12-06 - 来自专栏剪映小助手
【剪映小助手】提交视频生成任务
提交视频生成任务。该接口采用异步处理模式，立即返回任务提交状态，视频生成在后台进行。支持任务排队，确保系统稳定性。
50610编辑于 2025-12-06 - 来自专栏剪映小助手
【剪映小助手】获取文字出入场动画列表
获取文字出入场动画列表，返回所有支持的且满足条件的文字出入场动画。支持根据动画类型（入场、出场、循环）和会员模式（所有、VIP、免费）进行筛选。
34710编辑于 2025-12-06 - 来自专栏剪映小助手
【剪映小助手】故障排除与常见问题
内容覆盖剪映自动化失败、API调用异常、Docker部署问题、性能问题排查、内存泄漏检测与系统兼容性处理，并提供日志分析技巧与问题定位步骤，帮助用户自助解决大部分问题。 后端负责API路由、中间件、日志与剪映草稿下载；桌面客户端负责草稿下载、日志与历史记录管理；Dockerfile与docker-compose.yaml提供容器化部署。 ：解析草稿URL、获取文件列表、逐个下载并写入本地，必要时更新JSON路径，最后通过robocopy触发剪映目录扫描。 ，避免剪映未及时发现新增文件。 参考路径：desktop-client/main.js、desktop-client/main.js二、剪映自动化失败症状：草稿下载成功但剪映未识别排查要点：确认触发目录扫描成功；检查robocopy返回码
19910编辑于 2026-03-18 - 来自专栏剪映小助手
【开源剪映小助手-客户端】目录扫描功能
目录扫描功能目录扫描功能概述目录扫描功能是CapCutMate项目中的核心特性之一，主要用于实现剪映草稿文件的自动发现和管理。 该功能通过模拟文件系统变更事件，使剪映应用程序能够自动检测到新下载的草稿文件，而无需重启应用程序。 SyncDir["同步目录结构"]CopyDir-->TriggerEvent["触发文件系统事件"]SyncDir-->TriggerEventTriggerEvent-->UpdateJianying["更新剪映草稿列表 常见问题及解决方案问题类型症状描述解决方案扫描失败目录扫描无响应检查目标目录权限Windows错误robocopy返回码>=8检查磁盘空间和文件锁定macOS错误rsync执行失败检查文件系统权限草稿未显示新下载草稿不在剪映中手动重启剪映应用程序
13210编辑于 2026-04-05 - 来自专栏剪映小助手
【剪映小助手】向现有草稿中添加贴纸
该接口用于在指定的时间段内添加贴纸素材到剪映草稿中，支持贴纸的缩放和位置调整。贴纸可以用于增强视频的视觉效果，如表情、装饰、文字等。 单位为像素正值向下移动负值向上移动以画布中心为原点实际存储时会转换为半画布高单位（假设画布高度1080，即除以540）贴纸ID说明sticker_id:贴纸的唯一标识符格式：通常为数字字符串示例："7326810673609018675"获取方式：通过剪映贴纸库或相关
39510编辑于 2025-12-06 【剪映小助手】为文本创建富文本样式
为文本创建富文本样式，支持关键词高亮、颜色设置、字体大小调整等功能。该接口可以将普通文本转换为包含样式信息的富文本格式，实现关键词突出显示、多样化的文本展示效果。
33510编辑于 2025-12-06- 来自专栏剪映小助手
【剪映小助手-客户端】构建与部署
本指南面向 capcut-mate 桌面客户端的构建与部署，覆盖 Electron 应用的构建流程、打包配置、发布策略、版本管理、自动更新机制与签名验证流程，并提供开发环境配置、调试工具使用与生产环境部署的最佳实践。文档同时涵盖跨平台兼容性处理、安装包优化与分发渠道管理的实操建议。
23910编辑于 2026-03-19 - 来自专栏剪映小助手
【开源剪映小助手-客户端】前端界面设计
切换页码|ChangePage["更新当前页并渲染"]Interact-->|无|End(["结束"])Copy-->EndChangePage-->Render配置中心页面（路径设置）功能：读取并展示剪映草稿保存路径
13510编辑于 2026-04-06 - 来自专栏剪映小助手
【剪映小助手】向现有草稿中添加视频特效
该接口用于在指定的时间段内添加特效素材到剪映草稿中，支持多种特效类型如边框特效、滤镜特效、动态特效等。特效可以用于增强视频的视觉效果。 1,000,000微秒）end:特效在时间轴上的结束时间，单位为微秒duration:特效显示时长=end-start特效名称说明effect_title:特效的名称格式：字符串示例："录制边框III"获取方式：通过剪映特效库或相关
36910编辑于 2025-12-06 - 来自专栏剪映小助手
【剪映小助手】向现有草稿中批量添加字幕
该接口用于在指定的时间段内添加字幕到剪映草稿中，支持丰富的字幕样式设置，包括文本颜色、边框颜色、对齐方式、透明度、字体、字体大小、字间距、行间距、缩放和位置调整等。 draft_id=2025092811473036584258","captions":"[{\"start\":0,\"end\":10000000,\"text\":\"你好，剪映\",\"keyword application/json"\-d'{"draft_url":"YOUR_DRAFT_URL","captions":"[{\"start\":0,\"end\":5000000,\"text\":\"你好，剪映 application/json"\-d'{"draft_url":"YOUR_DRAFT_URL","captions":"[{\"start\":0,\"end\":5000000,\"text\":\"你好，剪映 application/json"\-d'{"draft_url":"YOUR_DRAFT_URL","captions":"[{\"start\":0,\"end\":5000000,\"text\":\"你好，剪映
59110编辑于 2025-12-06 - 来自专栏剪映小助手
【开源剪映小助手-客户端】Node.js 集成
本文件面向开发者，系统性阐述 capcut-mate 桌面客户端中 Node.js 与 Electron 的集成方案，重点覆盖以下方面：
10710编辑于 2026-03-23
腾讯云开发者
Copyright © 2013 - 2026 Tencent Cloud. All Rights Reserved. 腾讯云 版权所有
深圳市腾讯计算机系统有限公司 ICP备案/许可证号：粤B2-20090059 
粤公网安备44030502008569号
腾讯云计算（北京）有限责任公司 京ICP证150476号 | 京ICP备11018762号