在扣子中收藏插件
如果您想自己动手搭建工作流,可在扣子平台中收藏此插件以备使用
桌面端 剪映草稿助手
您还可以将工作流创作的视频,通过桌面端工具下载到自己电脑的剪映中
剪映草稿助手 插件中各工具的输入/输出参数说明:
创建草稿 (create_draft)
用于快速初始化一个新的剪映视频项目草稿。create_draft - 输入参数
integer
视频画布宽度,默认值为
1080,单位 像素。integer
视频画布高度,默认值为
1920,单位 像素。create_draft - 输出参数
boolean
是否执行成功,
true 成功,false 失败。string
错误信息,如果没有执行成功,这里会显示错误信息,否则为空。
string
草稿唯一编码,用于后续向该草稿添加素材、特效等操作。
保存草稿 (save_draft)
将已生成的所有配置、轨道数据、文字样式及媒体素材保存为标准的剪映草稿工程文件。save_draft - 输入参数
string
required
草稿编码,指定要保存的草稿编码,一般来自于
创建草稿 (create_draft) 工具的输出参数。string
required
合芯栈道 API 密钥,用于识别和验证身份的凭证
免费获取。- 免费获取方式:登录 合芯栈道 - 会员中心,在
API 密钥版块中查看。 - 重要安全建议:
- 建议通过工作流开始节点的输入参数的形式使用,而不是直接明文写入插件工具的参数中。
- 请防止在分享工作流调试记录或截图时无意间展示密钥信息。
- 密钥失效处理:若密钥存在泄露风险,请立即在会员中心进行重置,原密钥将即刻失效。
string
草稿标题,自定义一个草稿标题,方便后期在 合芯栈道 - 我生成的草稿 中查阅。
string
工作流名称,用于备注所使用的工作流的名称。
save_draft - 输出参数
boolean
是否执行成功,
true 成功,false 失败。string
错误信息,如果没有执行成功,这里会显示错误信息,否则为空。
string
草稿唯一编码,返回草稿编码,可提供给 桌面端 剪映草稿助手 下载整个草稿工程。
添加音频 (add_audio)
用于向指定的剪映草稿中添加音频素材。add_audio - 输入参数
string
required
音频网址,必须是公开可访问的链接,音频格式支持
mp3 wma wav aac m4a flac 等。string
required
草稿编码,指定要添加到的草稿编码,一般来自于
创建草稿 (create_draft) 工具的输出参数。number
required
时间轴入场点,音频在时间轴上开始播放的位置,单位
秒。number
required
音频时长,单位
秒,-1 表示取当前整个时间轴的时长。number
音频裁剪起始位置,设置音频片段在原始文件中的开始截取点。默认从
0(开头)开始,单位 秒。number
音频裁剪结束位置,设置音频片段在原始文件中的停止截取点,单位
秒。cut_end 应大于 cut_start。number
声音大小,范围
0 ~ 1,默认值 1。number
播放速度,默认
1 为原速,数值越大速度越快。string
目标轨道名称,指定当前音频要插入的轨道名称,若轨道不存在会自动新建。
add_audio - 输出参数
boolean
是否执行成功,
true 成功,false 失败。string
错误信息,如果没有执行成功,这里会显示错误信息,否则为空。
object
添加视频 (add_video)
用于向指定的剪映草稿中添加视频素材。add_video - 输入参数
string
required
视频网址,必须是公开可访问的链接,视频格式支持
mp4 mov avi wmv f4v m4v mpg mpeg4 mkv flv rmvb mts m2ts m2t ts mxf webm 等。string
required
草稿编码,指定要添加到的草稿编码,一般来自于
创建草稿 (create_draft) 工具的输出参数。number
required
时间轴入场点,视频在时间轴上开始播放的位置,单位
秒。number
required
视频时长,视频在时间轴上播放的时间长度,单位
秒,-1 表示取当前整个时间轴的时长。number
视频裁剪起始位置,设置视频片段在原始文件中的开始截取点。默认从
0(开头)开始,单位 秒。number
视频裁剪结束位置,设置视频片段在原始文件中的停止截取点,单位
秒。cut_end 应大于 cut_start。number
声音大小,控制视频播放时的声音大小,范围
0 ~ 1,1 原始音量,0 静音,默认值 1。number
播放速度,控制视频在时间轴上的播放快慢,默认值
1 为原始速度,数值越大速度越快。number
缩放比例,控制视频在画面中的大小比例,默认值
1 为原始大小,> 1 为放大,< 1 为缩小。number
X轴位置,范围
-1 ~ 1,0 水平居中,-1 画面最左侧,1 画面最右侧,默认值 0。number
Y轴位置,范围
-1 ~ 1,0 垂直居中,-1 画面底端,1 画面顶端,默认值 0。integer
层级关系,用于控制多个素材在空间位置上重叠时,谁在上层,谁在下层。数值越高越接近前景,默认值
0。number
转场时长,控制转场展示的时间长度,单位
秒,必须先设置 transition 参数。string
目标轨道名称,指定当前视频要插入的轨道名称,若轨道不存在会自动新建。
add_video - 输出参数
boolean
是否执行成功,
true 成功,false 失败。string
错误信息,如果没有执行成功,这里会显示错误信息,否则为空。
object
添加图片 (add_image)
用于向指定的剪映草稿中添加图片素材。add_image - 输入参数
string
required
图片网址,必须是公开可访问的链接,图片格式支持
jpeg png gif bmp webp 等。string
required
草稿编码,指定要添加到的草稿编码,一般来自于
创建草稿 (create_draft) 工具的输出参数。number
required
时间轴入场点,图片在时间轴上开始显示的位置,单位
秒。number
时间轴出场点,图片在时间轴上结束显示的位置,默认值
3,单位 秒,-1 表示取当前整个时间轴的结束位置。timeline_end 应大于 timeline_startnumber
缩放比例,控制图片在画面中的大小比例,默认值
1 为原始大小,> 1 为放大,< 1 为缩小。number
X轴位置,范围
-1 ~ 1,0 水平居中,-1 画面最左侧,1 画面最右侧,默认值 0。number
Y轴位置,范围
-1 ~ 1,0 垂直居中,-1 画面底端,1 画面顶端,默认值 0。integer
层级关系,用于控制多个素材在空间位置上重叠时,谁在上层,谁在下层。数值越高越接近前景,默认值
0。number
转场时长,控制转场展示的时间长度,单位
秒,必须先设置 transition 参数。number
入场动画时长,控制入场动画展示的时间长度,单位
秒,必须先设置 intro_animation 参数。number
出场动画时长,控制出场动画展示的时间长度,单位
秒,必须先设置 outro_animation 参数。string
目标轨道名称,指定当前图片要插入的轨道名称,若轨道不存在会自动新建。
add_image - 输出参数
boolean
是否执行成功,
true 成功,false 失败。string
错误信息,如果没有执行成功,这里会显示错误信息,否则为空。
object
添加文字 (add_text)
用于向指定的剪映草稿中添加文字素材。add_text - 输入参数
string
required
文本内容,设置要添加的文本内容。
string
required
草稿编码,指定要添加到的草稿编码,一般来自于
创建草稿 (create_draft) 工具的输出参数。number
required
时间轴入场点,文本在时间轴上开始显示的位置,单位
秒。number
时间轴出场点,文本在时间轴上结束显示的位置,默认值
3,单位 秒,-1 表示取当前整个时间轴的结束位置。timeline_end 应大于 timeline_startnumber
时间偏移量,用于微调文本出现的时间,解决音画不同步问题,单位
秒。正值 延迟出现,负值 提前出现integer
字号,用于设置文本字体显示的大小,默认值
8。string
文字颜色,格式为标准十六进制颜色代码,默认值
#ffffff。number
文字透明度,范围
0 ~ 1,0 完全透明,1 不透明,默认值 0。integer
文字描边粗细,用于增强文字在复杂背景下的可读性,默认值
0 表示无描边。string
文字描边颜色,格式为标准十六进制颜色代码,例如
#000000。number
文字背景透明度,范围
0 ~ 1,0 完全透明,1 不透明,默认值 0。string
文字背景颜色,衬托于文字之下的色块,格式为标准十六进制颜色代码,例如
#ffff00。number
文字背景圆角半径,用于调整文字背景色块四个角的圆润程度,范围
0 ~ 1。number
文字背景左右边距,用于控制背景色块在文字左右两侧的延伸长度,范围
0 ~ 1。number
文字背景上下边距,用于控制背景色块在文字上下两端的延伸高度,范围
0 ~ 1。integer
文字行间距,用于控制多行文本之间的垂直间隔距离。
boolean
开启纵向排列,决定文本的排版方向是水平(横排)还是垂直(竖排),默认值
false。number
文本框固定宽度比例,文本框相对屏幕的最大宽度比例,范围
0 ~ 1,-1 表示不限制,默认值 0.5。number
文本框固定高度比例,文本框相对屏幕的最大高度比例,范围
0 ~ 1,-1 表示不限制,默认值 -1。number
X轴位置,范围
-1 ~ 1,0 水平居中,-1 画面最左侧,1 画面最右侧,默认值 0。number
Y轴位置,范围
-1 ~ 1,0 垂直居中,-1 画面底端,1 画面顶端,默认值 0。number
入场动画时长,控制入场动画展示的时间长度,单位
秒,必须先设置 intro_animation 参数。number
出场动画时长,控制出场动画展示的时间长度,单位
秒,必须先设置 outro_animation 参数。string
目标轨道名称,指定当前文本要插入的轨道名称,若轨道不存在会自动新建。
add_text - 输出参数
boolean
是否执行成功,
true 成功,false 失败。string
错误信息,如果没有执行成功,这里会显示错误信息,否则为空。
object
添加关键帧 (add_keyframe)
用于向指定的剪映草稿中添加关键帧。add_keyframe - 输入参数
string
required
草稿编码,指定要添加到的草稿编码,一般来自于
创建草稿 (create_draft) 工具的输出参数。string
关键帧属性值(单帧),设置单个键帧作用的动画属性值。
number
关键帧时间点(单帧),设置添加单个关键帧的时间点,单位
秒。number
关键帧时间点偏移量(单帧),可在毫秒级尺度上微调单个关键帧时间点,以避免重合失效,单位
秒。array<string>
关键帧属性名称列表(多帧),指定一组关键帧作用的多个动画属性名称。输入示例(同时控制旋转和缩放的复合动画):
["rotation", "rotation", "uniform_scale", "uniform_scale"]插件支持哪些关键帧属性?请参考本页的 [ 关键帧属性 快查表 ] 部分。array<string>
关键帧属性值列表(多帧),设置一组关键帧作用的多个动画属性值,数量必须与
kfs_propertys 中数量一致。输入示例(同时设置旋转和缩放动画的起始和结束帧的数值):["0", "30", "0.47", "0.7"]array<number>
关键帧时间点列表(多帧),设置添加多个关键帧的时间点,数量必须与
kfs_propertys 中数量一致。输入示例(同时设置旋转和缩放动画的起始和结束帧的时间点):[1.53, 3, 1.53, 3]string
目标轨道名称,指定当前关键帧或关键帧列表要插入的轨道名称,若轨道不存在会自动新建。
add_keyframe - 输出参数
boolean
是否执行成功,
true 成功,false 失败。string
错误信息,如果没有执行成功,这里会显示错误信息,否则为空。
object
添加特效 (add_effect)
用于向指定的剪映草稿中添加文字素材。add_effect - 输入参数
string
required
草稿编码,指定要添加到的草稿编码,一般来自于
创建草稿 (create_draft) 工具的输出参数。number
required
时间轴入场点,特效在时间轴上开始显示的位置,单位
秒。number
时间轴出场点,特效在时间轴上结束显示的位置,默认值
3,单位 秒,-1 表示取当前整个时间轴的结束位置。timeline_end 应大于 timeline_startstring
目标轨道名称,指定当前特效要插入的轨道名称,若轨道不存在会自动新建。
add_effect - 输出参数
boolean
是否执行成功,
true 成功,false 失败。string
错误信息,如果没有执行成功,这里会显示错误信息,否则为空。
object
添加贴纸 (add_sticker)
用于向指定的剪映草稿中添加贴纸素材。add_sticker - 输入参数
string
required
贴纸编码,设置要添加的贴纸编码。如何获得贴纸编码?需要先在剪映的任意测试草稿中手动添加想要的贴纸,然后从该草稿的工程文件中,找到对应的贴纸编码并记录下来。
string
required
草稿编码,指定要添加到的草稿编码,一般来自于
创建草稿 (create_draft) 工具的输出参数。number
required
时间轴入场点,贴纸在时间轴上开始显示的位置,单位
秒。number
时间轴出场点,贴纸在时间轴上结束显示的位置,默认值
3,单位 秒,-1 表示取当前整个时间轴的结束位置。timeline_end 应大于 timeline_startnumber
缩放比例,控制贴纸在画面中的大小比例,默认值
1 为原始大小,> 1 为放大,< 1 为缩小。number
X轴位置,范围
-1 ~ 1,0 水平居中,-1 画面最左侧,1 画面最右侧,默认值 0。number
Y轴位置,范围
-1 ~ 1,0 垂直居中,-1 画面底端,1 画面顶端,默认值 0。number
旋转角度,顺时针旋转,可正可负,单位
度,默认值 0。number
透明度,范围
0 ~ 1,0 完全透明,1 不透明,默认值 1。integer
层级关系,用于控制多个素材在空间位置上重叠时,谁在上层,谁在下层。数值越高越接近前景,默认值
0。string
目标轨道名称,指定当前贴纸要插入的轨道名称,若轨道不存在会自动新建。
add_sticker - 输出参数
boolean
是否执行成功,
true 成功,false 失败。string
错误信息,如果没有执行成功,这里会显示错误信息,否则为空。
object