Skip to main content

在扣子中收藏插件

如果您想自己动手搭建工作流,可在扣子平台中收藏此插件以备使用

桌面端 剪映草稿助手

您还可以将工作流创作的视频,通过桌面端工具下载到自己电脑的剪映中
以下是 剪映草稿助手 插件中各工具的输入/输出参数说明:

创建草稿 (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。
string
转场效果,设置当前素材要使用的转场的名称。插件支持哪些转场?请参考本页的 [ 转场 快查表 ] 部分。
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_start
number
缩放比例,控制图片在画面中的大小比例,默认值 1 为原始大小,> 1 为放大,< 1 为缩小。
number
X轴位置,范围 -1 ~ 1,0 水平居中,-1 画面最左侧,1 画面最右侧,默认值 0。
number
Y轴位置,范围 -1 ~ 1,0 垂直居中,-1 画面底端,1 画面顶端,默认值 0。
integer
层级关系,用于控制多个素材在空间位置上重叠时,谁在上层,谁在下层。数值越高越接近前景,默认值 0。
string
转场效果,设置当前素材要使用的转场的名称。插件支持哪些转场?请参考本页的 [ 转场 快查表 ] 部分。
number
转场时长,控制转场展示的时间长度,单位 秒,必须先设置 transition 参数。
string
入场动画,设置当前素材要使用的入场动画的名称。插件支持哪些入场动画?请参考本页的 [ 入场动画 快查表 ] 部分。
number
入场动画时长,控制入场动画展示的时间长度,单位 秒,必须先设置 intro_animation 参数。
string
出场动画,设置当前素材要使用的出场动画的名称。插件支持哪些出场动画?请参考本页的 [ 出场动画 快查表 ] 部分。
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_start
number
时间偏移量,用于微调文本出现的时间,解决音画不同步问题,单位 秒。正值 延迟出现,负值 提前出现
string
字体,设置文本显示的字体样式,默认值 抖音美好体。插件支持哪些字体?请参考本页的 [ 字体 快查表 ] 部分。
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。
string
入场动画,设置当前素材要使用的入场动画的名称。插件支持哪些入场动画?请参考本页的 [ 入场动画 快查表 ] 部分。
number
入场动画时长,控制入场动画展示的时间长度,单位 秒,必须先设置 intro_animation 参数。
string
出场动画,设置当前素材要使用的出场动画的名称。插件支持哪些出场动画?请参考本页的 [ 出场动画 快查表 ] 部分。
number
出场动画时长,控制出场动画展示的时间长度,单位 秒,必须先设置 outro_animation 参数。
string
目标轨道名称,指定当前文本要插入的轨道名称,若轨道不存在会自动新建。

add_text - 输出参数

boolean
是否执行成功,true 成功,false 失败。
string
错误信息,如果没有执行成功,这里会显示错误信息,否则为空。
object

添加关键帧 (add_keyframe)

用于向指定的剪映草稿中添加关键帧。

add_keyframe - 输入参数

在关键帧的输入参数中包含 单帧 和 多帧 两套方案,这两套方案不能同时使用。使用 单帧 方案每次只能添加 1 个关键帧,而 多帧 方案可以用数组的形式一次性添加多个关键帧。
string
required
草稿编码,指定要添加到的草稿编码,一般来自于 创建草稿 (create_draft) 工具的输出参数。
string
关键帧属性名称(单帧),指定单个关键帧作用的动画属性名称。插件支持哪些关键帧属性?请参考本页的 [ 关键帧属性 快查表 ] 部分。
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
特效名称,设置要添加的特效名称。插件支持哪些特效?请参考本页的 [ 特效 快查表 ] 部分。
string
required
草稿编码,指定要添加到的草稿编码,一般来自于 创建草稿 (create_draft) 工具的输出参数。
number
required
时间轴入场点,特效在时间轴上开始显示的位置,单位 秒。
number
时间轴出场点,特效在时间轴上结束显示的位置,默认值 3,单位 秒,-1 表示取当前整个时间轴的结束位置。timeline_end 应大于 timeline_start
string
目标轨道名称,指定当前特效要插入的轨道名称,若轨道不存在会自动新建。

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_start
number
缩放比例,控制贴纸在画面中的大小比例,默认值 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

资源参考附录

您可以在此查找本插件支持的各种剪映资源,以及它们对应的名称,帮助您准确填写相关的参数值。

字体 快查表

您可以在本表中快速查找:字体名称。
当使用插件中的 font 参数时,填写表中的 字体名称 即可。

转场 快查表

您可以在本表中快速查找:转场效果名称 (默认时长)。
当使用插件中的 transition 参数时,填写表中的 转场效果名称 即可。

入场动画 快查表

您可以在本表中快速查找:入场动画名称 (默认时长)。
当使用插件中的 intro_animation 参数时,填写表中的 入场动画名称 即可。

出场动画 快查表

您可以在本表中快速查找:出场动画名称 (默认时长)。
当使用插件中的 outro_animation 参数时,填写表中的 出场动画名称 即可。

关键帧属性 快查表

您可以在本表中快速查找:关键帧属性名称。
当使用插件中的 kf_property 或 kf_propertys 参数时,填写表中的 关键帧属性名称 即可。

特效 快查表

您可以在本表中快速查找:特效名称。
当使用插件中的 effect_name 参数时,填写表中的 特效名称 即可。