剪映智能剪辑API汇总

Hommy882025-12-03 16:20

剪映智能剪辑API汇总

本文档汇总了剪映智能剪辑（CapCut Mate）的所有API接口，方便开发者快速了解和使用这些接口进行视频剪辑自动化操作。

目录

  1. 基础草稿操作
  2. 素材添加接口
  3. 效果增强接口
  4. 字幕与文本接口
  5. 动画与特效接口
  6. 视频生成接口
  7. 辅助工具接口

基础草稿操作

1. 创建草稿

接口地址

复制代码 
POST /openapi/capcut-mate/v1/create_draft

请求参数

参数名 类型 必填 默认值 说明
width number ❌ 1920 视频宽度(像素)，必须大于等于1
height number ❌ 1080 视频高度(像素)，必须大于等于1

响应参数

字段名 类型 说明
draft_url string 新创建的草稿URL，用于后续的编辑操作
tip_url string 草稿使用帮助文档URL

2. 保存草稿

接口地址

复制代码 
POST /openapi/capcut-mate/v1/save_draft

请求参数

参数名 类型 必填 默认值 说明
draft_url string ✅ - 要保存的草稿URL

响应参数

字段名 类型 说明
draft_url string 保存后的草稿URL，通常与请求中的URL相同

3. 获取草稿

接口地址

复制代码 
GET /openapi/capcut-mate/v1/get_draft

请求参数

参数名 类型 必填 默认值 说明
draft_id string ✅ - 草稿ID，长度为20-32位字符

响应参数

字段名 类型 说明
files array 草稿相关的文件列表

素材添加接口

1. 添加视频

接口地址

复制代码 
POST /openapi/capcut-mate/v1/add_videos

请求参数

参数名 类型 必填 默认值 说明
draft_url string ✅ - 目标草稿的完整URL
video_infos string ✅ - 视频信息数组的JSON字符串
alpha number ❌ 1.0 全局透明度(0-1)
scale_x number ❌ 1.0 X轴缩放比例
scale_y number ❌ 1.0 Y轴缩放比例
transform_x number ❌ 0 X轴位置偏移(像素)
transform_y number ❌ 0 Y轴位置偏移(像素)

video_infos 数组结构

字段名 类型 必填 默认值 说明
video_url string ✅ - 视频文件的URL地址
width number ✅ - 视频宽度(像素)
height number ✅ - 视频高度(像素)
start number ✅ - 视频开始播放时间(微秒)
end number ✅ - 视频结束播放时间(微秒)
duration number ✅ - 视频总时长(微秒)
mask string ❌ - 遮罩类型
transition string ❌ - 转场效果名称
transition_duration number ❌ 500000 转场持续时间(微秒)
volume number ❌ 1.0 音量大小(0-1)

2. 添加图片

接口地址

复制代码 
POST /openapi/capcut-mate/v1/add_images

请求参数

参数名 类型 必填 默认值 说明
draft_url string ✅ - 目标草稿的完整URL
image_infos string ✅ - 图片信息数组的JSON字符串
alpha number ❌ 1.0 图片透明度，建议范围0.0, 1.0
scale_x number ❌ 1.0 图片X轴缩放比例
scale_y number ❌ 1.0 图片Y轴缩放比例
transform_x number ❌ 0 X轴位置偏移（像素）
transform_y number ❌ 0 Y轴位置偏移（像素）

image_infos 数组结构

字段名 类型 必填 默认值 说明
image_url string ✅ - 图片文件的URL地址
width number ✅ - 图片宽度(像素)
height number ✅ - 图片高度(像素)
start number ✅ - 图片开始显示时间(微秒)
end number ✅ - 图片结束显示时间(微秒)

3. 添加音频

接口地址

复制代码 
POST /openapi/capcut-mate/v1/add_audios

请求参数

参数名 类型 必填 默认值 说明
draft_url string ✅ - 目标草稿的完整URL
audio_infos string ✅ - 音频信息数组的JSON字符串

audio_infos 数组结构

字段名 类型 必填 默认值 说明
audio_url string ✅ - 音频文件的URL地址
start number ✅ - 音频开始播放时间(微秒)
end number ✅ - 音频结束播放时间(微秒)
duration number ✅ - 音频总时长(微秒)
volume number ❌ 1.0 音量大小(0.0-2.0)
audio_effect string ❌ None 音频效果名称

响应参数

字段名 类型 说明
draft_url string 更新后的草稿URL
track_id string 音频轨道ID
audio_ids array 添加的音频ID列表

效果增强接口

1. 添加特效

接口地址

复制代码 
POST /openapi/capcut-mate/v1/add_effects

请求参数

参数名 类型 必填 默认值 说明
draft_url string ✅ - 目标草稿的完整URL
effect_infos string ✅ - 特效信息列表的JSON字符串

effect_infos 数组结构

字段名 类型 必填 默认值 说明
effect_title string ✅ - 特效名称/标题，必选参数
start number ✅ - 特效开始时间（微秒），必选参数
end number ✅ - 特效结束时间（微秒），必选参数

响应参数

字段名 类型 说明
draft_url string 更新后的草稿URL
track_id string 特效轨道ID
effect_ids array 添加的特效ID列表
segment_ids array 创建的特效片段ID列表

2. 添加贴纸

接口地址

复制代码 
POST /openapi/capcut-mate/v1/add_sticker

请求参数

参数名 类型 必填 默认值 说明
draft_url string ✅ - 目标草稿的完整URL
sticker_id string ✅ - 贴纸的唯一标识ID
start number ✅ - 贴纸开始时间（微秒）
end number ✅ - 贴纸结束时间（微秒）
scale number ❌ 1.0 贴纸缩放比例，建议范围0.1, 5.0
transform_x number ❌ 0 X轴位置偏移（像素）
transform_y number ❌ 0 Y轴位置偏移（像素）

响应参数

字段名 类型 说明
draft_url string 更新后的草稿URL
sticker_id string 贴纸的唯一标识ID
track_id string 贴纸轨道ID
segment_id string 创建的贴纸片段ID
duration number 贴纸显示时长（微秒）

3. 添加关键帧

接口地址

复制代码 
POST /openapi/capcut-mate/v1/add_keyframes

请求参数

参数名 类型 必填 默认值 说明
draft_url string ✅ - 目标草稿的完整URL
keyframes string ✅ - 关键帧信息列表的JSON字符串

keyframes 数组结构

字段名 类型 必填 说明
segment_id string ✅ 目标片段的唯一标识ID
property string ✅ 动画属性类型
offset number ✅ 关键帧在片段中的时间偏移（0-1范围）
value number ✅ 属性在该时间点的值

支持的动画属性类型

属性类型 描述 值范围
KFTypePositionX X轴位置 -1.0 到 1.0
KFTypePositionY Y轴位置 -1.0 到 1.0
KFTypeScaleX X轴缩放 0.1 到 10.0
KFTypeScaleY Y轴缩放 0.1 到 10.0
KFTypeRotation 旋转角度 -360 到 360
KFTypeAlpha 透明度 0.0 到 1.0

响应参数

字段名 类型 说明
draft_url string 更新后的草稿URL
keyframes_added integer 添加的关键帧数量
affected_segments array 受影响的片段ID列表

4. 添加遮罩

接口地址

复制代码 
POST /openapi/capcut-mate/v1/add_masks

请求参数

参数名 类型 必填 默认值 说明
draft_url string ✅ "" 目标草稿的完整URL
segment_ids array ✅ \[\] 要应用遮罩的片段ID数组
name string ❌ "线性" 遮罩类型名称
X integer ❌ 0 遮罩中心X坐标（像素）
Y integer ❌ 0 遮罩中心Y坐标（像素）
width integer ❌ 512 遮罩宽度（像素）
height integer ❌ 512 遮罩高度（像素）
feather integer ❌ 0 羽化程度（0-100）
rotation integer ❌ 0 旋转角度（度）
invert boolean ❌ false 是否反转遮罩
roundCorner integer ❌ 0 圆角半径（0-100）

字幕与文本接口

1. 添加字幕

接口地址

复制代码 
POST /openapi/capcut-mate/v1/add_captions

请求参数

参数名 类型 必填 默认值 说明
draft_url string ✅ - 目标草稿的完整URL
captions string ✅ - 字幕信息列表的JSON字符串
text_color string ❌ "#ffffff" 文本颜色（十六进制）
border_color string ❌ null 边框颜色（十六进制）
alignment integer ❌ 1 文本对齐方式（0-5）
alpha number ❌ 1.0 文本透明度（0.0-1.0）
font string ❌ null 字体名称
font_size integer ❌ 15 字体大小
letter_spacing number ❌ null 字间距
line_spacing number ❌ null 行间距
scale_x number ❌ 1.0 水平缩放比例
scale_y number ❌ 1.0 垂直缩放比例
transform_x integer ❌ 0 X轴位置偏移（像素）
transform_y integer ❌ 0 Y轴位置偏移（像素）
style_text boolean ❌ false 是否使用样式文本

captions 数组结构

字段名 类型 必填 默认值 说明
start integer ✅ - 字幕开始时间（微秒）
end integer ✅ - 字幕结束时间（微秒）
text string ✅ - 字幕文本内容
keyword string ❌ null 关键词（用|分隔多个关键词）
keyword_color string ❌ "#ff7100" 关键词颜色
keyword_font_size integer ❌ 15 关键词字体大小
font_size integer ❌ 15 文本字体大小
in_animation string ❌ null 入场动画
out_animation string ❌ null 出场动画
loop_animation string ❌ null 循环动画
in_animation_duration integer ❌ null 入场动画时长
out_animation_duration integer ❌ null 出场动画时长
loop_animation_duration integer ❌ null 循环动画时长

2. 添加文本样式

接口地址

复制代码 
POST /openapi/capcut-mate/v1/add_text_style

请求参数

参数名 类型 必填 默认值 说明
text string ✅ - 要处理的文本内容
keyword string ✅ - 关键词，多个用 | 分隔
font_size number ❌ 12 普通文本的字体大小
keyword_color string ❌ "#ff7100" 关键词文本颜色（十六进制）
keyword_font_size number ❌ 15 关键词字体大小

响应参数

字段名 类型 说明
text_style string 文本样式JSON字符串，包含styles数组和text字段

动画与特效接口

1. 获取文本动画列表

接口地址

复制代码 
POST /openapi/capcut-mate/v1/get_text_animations

请求参数

参数名 类型 必填 默认值 说明
mode integer ❌ 0 动画模式：0=所有，1=VIP，2=免费
type string ✅ - 动画类型：in=入场，out=出场，loop=循环

响应参数

字段名 类型 说明
effects array 文本动画对象数组

动画对象字段说明

字段名 类型 说明
resource_id string 动画资源ID
type string 动画类型
category_id string 分类ID
category_name string 分类名称
duration number 动画时长（微秒）
id string 动画ID
name string 动画名称
icon_url string 动画图标URL

2. 获取图片动画列表

接口地址

复制代码 
POST /openapi/capcut-mate/v1/get_image_animations

请求参数

参数名 类型 必填 默认值 说明
mode integer ❌ 0 动画模式：0=所有，1=VIP，2=免费
type string ✅ - 动画类型：in=入场，out=出场，loop=循环

响应参数

字段名 类型 说明
effects array 图片动画对象数组

动画对象字段说明

字段名 类型 说明
resource_id string 动画资源ID
type string 动画类型
category_id string 分类ID
category_name string 分类名称
duration number 动画时长（微秒）
id string 动画ID
name string 动画名称
icon_url string 动画图标URL

视频生成接口

1. 生成视频

接口地址

复制代码 
POST /openapi/capcut-mate/v1/gen_video

请求参数

参数名 类型 必填 默认值 说明
draft_url string ✅ - 目标草稿的完整URL

响应参数

字段名 类型 说明
message string 响应消息

2. 查询视频生成状态

接口地址

复制代码 
POST /openapi/capcut-mate/v1/gen_video_status

请求参数

参数名 类型 必填 默认值 说明
draft_url string ✅ - 草稿URL，与提交任务时使用的URL相同

响应参数

字段名 类型 说明
draft_url string 草稿URL
status string 任务状态（pending/processing/completed/failed）
progress number 进度百分比
video_url string 生成的视频URL（完成时返回）
error_message string 错误信息（失败时返回）
created_at string 任务创建时间
started_at string 任务开始时间
completed_at string 任务完成时间

辅助工具接口

1. 获取音频时长

接口地址

复制代码 
POST /openapi/capcut-mate/v1/get_audio_duration

请求参数

参数名 类型 必填 默认值 说明
mp3_url string ✅ - 音频文件URL，支持mp3、wav、m4a等常见音频格式

响应参数

字段名 类型 说明
duration number 音频时长，单位：微秒

2. 简易创建素材

接口地址

复制代码 
POST /openapi/capcut-mate/v1/easy_create_material

请求参数

参数名 类型 必填 默认值 说明
draft_url string ✅ - 目标草稿的完整URL
audio_url string ✅ - 音频文件URL，不能为空或null
text string ❌ null 要添加的文字内容
img_url string ❌ null 图片文件URL
video_url string ❌ null 视频文件URL
text_color string ❌ "#ffffff" 文字颜色（十六进制格式）
font_size integer ❌ 15 字体大小
text_transform_y integer ❌ 0 文字Y轴位置偏移

项目信息

开源项目地址

GitHub: https://github.com/jcaigc/capcut-mate

剪映小助手下载地址

官网: https://jcaigc.cn

相关推荐
ShineWinsu2 天前
对于Qt：QPushButton常见属性的解析
开发语言·c++·qt·api·gui·按钮·qpushbutton
星核0penstarry2 天前
企业 API 向后兼容实战：版本控制、废弃字段通知与灰度发布策略
人工智能·后端·api·接口隔离原则·版本控制·架构设计·后端架构
treasure1403 天前
Django复习笔记（2026年10月）
后端·python·django·api·web·drf
用户298698530144 天前
Python 将 Word 文档转换为 XML 的实践要点
后端·python·api
用户298698530145 天前
Python 实战：Markdown 转 PDF 的代码实现与页面设置
python·api·markdown
Tanshu_API君5 天前
白银期货行情数据接入：从上海期货交易所合约到实时报价
api·金属·白银·白银价格·白银历史价格
EnCi Zheng5 天前
后端怎么把AI接口稳定安全低成本接进业务：超时重试、密钥隔离与成本熔断清单
人工智能·后端·安全·架构·api
千木SilvaMux5 天前
10款国产模型写离职证明实测：为什么两极分化
llm·api
用户298698530147 天前
Python 实现 Markdown 与 Word 文档互转
python·api·markdown
むはちひつなゃ初见7 天前
LLM API 上线 FAQ 与排障清单：从 401/429 到 fallback 验收
llm·api·故障排查
热门推荐
01国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）02历年考研数学一、数学二、数学三真题试卷及答案PDF03GitHub 镜像站点04如何新建文件夹？ 电脑新建文件夹的4种方法05几个好用的ip纯净度检测网站06苹果iPA游戏软件资源下载网站07Android 屏幕适配系列开篇：核心概念、官方机制与主流方案08Dify：一站式AI应用开发平台全解析与Windows部署指南09蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接10UG NX12.0安装包下载与保姆级图文安装教程！！