剪映剪辑助手-草稿

显示全部

草稿

剪映剪辑助手 / 草稿 类动作。

新建草稿

create_jianying_draft

剪映剪辑助手草稿

用途：新建剪映草稿对象，并设为当前草稿；在动作流或本地上下文里先只保留内存对象，执行保存草稿时再正式落盘。

写法：新建草稿 草稿名=<草稿名> [画面宽度=<画面宽度>] [画面高度=<画面高度>] [帧率=<帧率>]

保存为

默认保存主结果，通常就是 草稿路径 这个字段。

正确示例

新建草稿 草稿名="示例名称" 画面宽度="示例值"

错误示例

新建草稿 画面宽度="示例值"

为什么错：漏写了必填参数：草稿名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
草稿名draft_name要创建的剪映草稿名称。是无
画面宽度width草稿画面宽度，默认 1920。否1920
画面高度height草稿画面高度，默认 1080。否1080
帧率fps草稿帧率，默认 30。否30

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
草稿名string否未提供说明
草稿路径string否未提供说明
画面宽度integer否未提供说明
画面高度integer否未提供说明
帧率integer否未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加 保存为=变量名，默认保存主结果字段 草稿路径。

读取草稿

read_jianying_draft

剪映剪辑助手草稿

用途：读取已有剪映草稿工程并设为当前草稿。

写法：读取草稿 草稿名=<草稿名> [安全检测=<安全检测>]

保存为

默认保存主结果，通常就是 草稿路径 这个字段。

正确示例

读取草稿 草稿名="示例名称" 安全检测="示例值"

错误示例

读取草稿 安全检测="示例值"

为什么错：漏写了必填参数：草稿名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
草稿名draft_name剪映草稿名称。是无
安全检测safe_check是否启用读取前安全检测。默认 False；开启后会复用保存草稿的活跃草稿和剪映窗口状态检查。否False

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
草稿路径string否未提供说明
草稿名string否未提供说明
轨道数量integer否未提供说明
片段数量integer否未提供说明
总时长integer否未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加 保存为=变量名，默认保存主结果字段 草稿路径。

保存草稿

save_jianying_draft

剪映剪辑助手草稿

用途：保存当前草稿并运行结构校验。支持控制另存为目标已存在时是否覆盖。

写法：保存草稿 [草稿名=<草稿名>] [覆盖已有=<覆盖已有>] [安全检测=<安全检测>]

保存为

默认保存主结果，通常就是 草稿路径 这个字段。

正确示例

保存草稿 草稿名="示例名称" 覆盖已有="示例值"

错误示例

保存草稿 草稿名="示例名称" 错误参数=1

为什么错：使用了不在当前参数表里的参数名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
草稿名draft_name可选；另存为的新草稿名。不填则保存到当前草稿名。否无
覆盖已有overwrite保存目标草稿已存在时是否覆盖，默认 True。否True
安全检测safe_check是否启用保存前安全检测。默认 True；关闭后会跳过活跃草稿和剪映窗口状态检查，直接保存。否True

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
状态string否未提供说明
草稿路径string否未提供说明
问题数量integer否未提供说明
错误数量integer否未提供说明
警告数量integer否未提供说明
问题类型分布object否未提供说明
问题级别分布object否未提供说明
问题列表array否未提供说明
草稿摘要object否未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加 保存为=变量名，默认保存主结果字段 草稿路径。

校验草稿

validate_jianying_draft

剪映剪辑助手草稿

用途：校验当前草稿或指定剪映草稿 draft_content.json 的素材引用和时间线。

写法：校验草稿 [草稿名=<草稿名>]

保存为

默认保存主结果，通常就是 问题列表 这个字段。

正确示例

校验草稿 草稿名="示例名称"

错误示例

校验草稿 草稿名="示例名称" 错误参数=1

为什么错：使用了不在当前参数表里的参数名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
草稿名draft_name可选；剪映草稿名称。不填时回退到当前草稿。否无

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
状态string否未提供说明
草稿路径string否未提供说明
问题数量integer否未提供说明
错误数量integer否未提供说明
警告数量integer否未提供说明
问题类型分布object否未提供说明
问题级别分布object否未提供说明
问题列表array否未提供说明
草稿摘要object否未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加 保存为=变量名，默认保存主结果字段 问题列表。

列出草稿

list_jianying_drafts

剪映剪辑助手草稿

用途：列出当前草稿根目录下的剪映草稿，支持按修改时间或名称排序。

写法：列出草稿 [关键词=<关键词>] [排序方式=<排序方式>] [倒序=<倒序>]

保存为

默认保存主结果，通常就是 草稿名列表 这个字段。

正确示例

列出草稿 关键词="示例值" 排序方式="示例值"

错误示例

列出草稿 关键词="示例值" 错误参数=1

为什么错：使用了不在当前参数表里的参数名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
关键词keyword可选；只返回草稿名包含该关键词的草稿。否无
排序方式sort_by排序方式，支持“修改时间”或“名称”，默认“修改时间”。否修改时间
倒序descending是否倒序排列，默认 True。否True

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
草稿名列表array否未提供说明
草稿名列表[*]string否数组元素
草稿列表array否未提供说明
草稿列表[*]object否数组元素
草稿列表[*].草稿名string否未提供说明
草稿列表[*].最后修改时间string否未提供说明
草稿列表[*].画面尺寸object否未提供说明
草稿列表[*].画面尺寸.宽度integer否未提供说明
草稿列表[*].画面尺寸.高度integer否未提供说明
草稿列表[*].帧率integer否未提供说明
草稿列表[*].总时长integer否未提供说明
草稿列表[*].轨道数量integer否未提供说明
草稿列表[*].片段数量integer否未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加 保存为=变量名，默认保存主结果字段 草稿名列表。

打开草稿

open_jianying_draft

剪映剪辑助手草稿

用途：通过剪映客户端打开指定剪映草稿，暂时不支持8.0以下版本，有需求再增加

写法：打开草稿 草稿名=<草稿名>

保存为

默认保存主结果，通常就是 草稿路径 这个字段。

正确示例

打开草稿 草稿名="示例名称"

错误示例

打开草稿

为什么错：漏写了必填参数：草稿名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
草稿名draft_name要打开的剪映草稿名称。是无

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
草稿路径string否未提供说明
草稿名string否未提供说明
轨道数量integer否未提供说明
片段数量integer否未提供说明
总时长integer否未提供说明
草稿IDstring否未提供说明
打开链接string否未提供说明
打开方式string否未提供说明
窗口句柄integer | null否未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加 保存为=变量名，默认保存主结果字段 草稿路径。

复制草稿

copy_jianying_draft

剪映剪辑助手草稿

用途：复制剪映草稿目录，并把复制出的草稿设为当前草稿。

写法：复制草稿 原草稿名=<原草稿名> 新草稿名=<新草稿名> [覆盖已有=<覆盖已有>]

保存为

默认保存主结果，通常就是 新草稿路径 这个字段。

正确示例

复制草稿 原草稿名="示例名称" 新草稿名="示例名称"

错误示例

复制草稿 原草稿名="示例名称"

为什么错：漏写了必填参数：新草稿名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
原草稿名src_draft_name现有草稿名称。是无
新草稿名dst_draft_name复制后的新草稿名称。是无
覆盖已有overwrite目标草稿已存在时是否覆盖。否True

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
原草稿名string否未提供说明
新草稿名string否未提供说明
原草稿路径string否未提供说明
新草稿路径string否未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加 保存为=变量名，默认保存主结果字段 新草稿路径。

删除草稿

delete_jianying_draft

剪映剪辑助手草稿

用途：删除指定剪映草稿目录。

写法：删除草稿 草稿名=<草稿名>

保存为

这个动作没有声明主结果字段时，行尾写 保存为=变量名 不会创建变量；如果要整份返回对象，请改用 返回结果=变量名。

正确示例

删除草稿 草稿名="示例名称"

错误示例

删除草稿

为什么错：漏写了必填参数：草稿名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
草稿名draft_name要删除的剪映草稿名称。是无

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

当前没有单独声明返回字段。

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加 保存为=变量名。

设置草稿属性

set_jianying_canvas

剪映剪辑助手草稿

用途：设置当前剪映草稿的画面宽度、高度、帧率和画面比例。

写法：设置草稿属性 [画面宽度=<画面宽度>] [画面高度=<画面高度>] [帧率=<帧率>] [画面比例=<画面比例>]

保存为

默认保存主结果，通常就是 草稿路径 这个字段。

正确示例

设置草稿属性 画面宽度="示例值" 画面高度="示例值"

错误示例

设置草稿属性 画面宽度="示例值" 错误参数=1

为什么错：使用了不在当前参数表里的参数名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
画面宽度width草稿画面宽度。否无
画面高度height草稿画面高度。否无
帧率fps草稿帧率。否无
画面比例ratio草稿画面比例，写入 canvas_config.ratio。否original

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
草稿路径string否未提供说明
画面宽度integer否未提供说明
画面高度integer否未提供说明
帧率integer否未提供说明
画面比例string否未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加 保存为=变量名，默认保存主结果字段 草稿路径。

设置草稿根目录

set_jianying_draft_root

剪映剪辑助手草稿

用途：设置当前动作流内使用的草稿根目录；只影响当前请求或当前动作流，不修改系统默认配置。

写法：设置草稿根目录 目录地址=<目录地址>

保存为

默认保存主结果，通常就是 草稿根目录 这个字段。

正确示例

设置草稿根目录 目录地址="示例值"

错误示例

设置草稿根目录

为什么错：漏写了必填参数：目录地址。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
目录地址draft_root当前动作流后续要使用的草稿根目录。是无

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
草稿根目录string否未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加 保存为=变量名，默认保存主结果字段 草稿根目录。