剪映智能剪辑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

相关推荐
高频因子挖掘机14 小时前
量化研究中，为什么拿到 Pandas 行情数据不等于完成数据接入？
后端·github·api
高频因子挖掘机15 小时前
股票 API 接入回测框架时最容易忽略的几个问题：复权、时间对齐与数据泄露
后端·github·api
学逆向的1 天前
win32注入代码
开发语言·网络安全·api·win32
VIP_CQCRE1 天前
用 Ace Data Cloud 接入 OpenAI 兼容语音转文字：一份能直接运行的 API 指南
python·openai·api·语音识别·acedatacloud
VIP_CQCRE1 天前
ChatBox 接入 Ace Data Cloud 实战：配置 OpenAI 兼容模型，附 404/401 排错
ai·api·chatbox·ace data cloud
高频因子挖掘机1 天前
历史 K 线突然少一天？用交易日历、停牌信息和数据校验逐步排查
后端·github·api
高频因子挖掘机1 天前
股票池一大就请求缓慢？量化系统批量获取行情的设计与优化
后端·github·api
高频因子挖掘机2 天前
量化回测前的数据审计：如何判断股票历史行情是否缺失、重复或存在偏差
后端·github·api
VIP_CQCRE2 天前
Nano Banana 图像 API：角色一致性、修图与商品图，一次接入怎么做？
api·ai绘图·图像生成·nano banana·ace data cloud
VIP_CQCRE2 天前
Visual Studio 接入 AI 助手：LMLocal × Ace Data Cloud 配置指南
大模型·api·ai编程·visual studio·acedatacloud
热门推荐
01国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）02历年考研数学一、数学二、数学三真题试卷及答案PDF03「全语录+省流版」邵艾伦 × 孙宇晨：聊风口、聊个人IP、聊年轻人如何抓住 AI 时代的机会04如何新建文件夹？ 电脑新建文件夹的4种方法05GitHub 镜像站点06蜘蛛磁力 搜索引擎大全，如何使用蜘蛛磁力查找磁力链接07轻量化AI渗透武器库｜ARTEX自主攻防系统、资产梳理、漏洞挖掘、链路分析全流程智能化落地08Windows 10/11 如何退出微软账户并改用本地账户登录（含找不到选项的解决方法）09Telegram APK 下载安装完整指南 — 2026年最新10微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新