> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hexinzhandao.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 插件 - 剪映草稿助手

> 剪映草稿助手为创作者们提供了在工作流中创建视频草稿、添加图片、音频、视频、文字、关键帧、特效等能力，以实现 AI 自动剪辑、一键出片，真正让创作者们把精力从制作转向创作。

<Columns cols={2}>
  <Card title="在扣子中收藏插件" icon="plug-circle-plus" href="https://www.coze.cn/store/plugin/7587625350935527487">
    如果您想自己动手搭建工作流，可在扣子平台中收藏此插件以备使用
  </Card>

  <Card title="桌面端 剪映草稿助手" icon="video-arrow-down-left" href="/zh/product/capcut-helper/installation">
    您还可以将工作流创作的视频，通过桌面端工具下载到自己电脑的剪映中
  </Card>
</Columns>

以下是 `剪映草稿助手` 插件中各工具的输入/输出参数说明：

## 创建草稿 (create\_draft)

用于快速初始化一个新的剪映视频项目草稿。

### create\_draft - 输入参数

<ParamField body="width" type="integer">
  **视频画布宽度**，默认值为 `1080`，单位 `像素`。
</ParamField>

<ParamField body="height" type="integer">
  **视频画布高度**，默认值为 `1920`，单位 `像素`。
</ParamField>

### create\_draft - 输出参数

<ResponseField name="success" type="boolean">
  **是否执行成功**，`true` 成功，`false` 失败。
</ResponseField>

<ResponseField name="error" type="string">
  **错误信息**，如果没有执行成功，这里会显示错误信息，否则为空。
</ResponseField>

<ResponseField name="draft_id" type="string">
  **草稿唯一编码**，用于后续向该草稿添加素材、特效等操作。
</ResponseField>

## 保存草稿 (save\_draft)

将已生成的所有配置、轨道数据、文字样式及媒体素材保存为标准的剪映草稿工程文件。

### save\_draft - 输入参数

<ParamField body="draft_id" type="string" required>
  **草稿编码**，指定要保存的草稿编码，一般来自于 `创建草稿 (create_draft)` 工具的输出参数。
</ParamField>

<ParamField body="hezhan_api_key" type="string" required>
  **合芯栈道 API 密钥**，用于识别和验证身份的凭证 `免费获取`。

  * **免费获取方式**：登录 [合芯栈道 - 会员中心](https://www.hexinzhandao.cn/user/home)，在 `API 密钥` 版块中查看。
  * **重要安全建议**：
    * 建议通过工作流开始节点的输入参数的形式使用，而不是直接明文写入插件工具的参数中。
    * 请防止在分享工作流调试记录或截图时无意间展示密钥信息。
  * **密钥失效处理**：若密钥存在泄露风险，请立即在会员中心进行重置，原密钥将即刻失效。
</ParamField>

<ParamField body="draft_title" type="string">
  **草稿标题**，自定义一个草稿标题，方便后期在 [合芯栈道 - 我生成的草稿](https://www.hexinzhandao.cn/user/drafts) 中查阅。
</ParamField>

<ParamField body="workflow_name" type="string">
  **工作流名称**，用于备注所使用的工作流的名称。
</ParamField>

### save\_draft - 输出参数

<ResponseField name="success" type="boolean">
  **是否执行成功**，`true` 成功，`false` 失败。
</ResponseField>

<ResponseField name="error" type="string">
  **错误信息**，如果没有执行成功，这里会显示错误信息，否则为空。
</ResponseField>

<ResponseField name="draft_id" type="string">
  **草稿唯一编码**，返回草稿编码，可提供给 [桌面端 剪映草稿助手](/zh/product/capcut-helper/installation) 下载整个草稿工程。
</ResponseField>

## 添加音频 (add\_audio)

用于向指定的剪映草稿中添加音频素材。

### add\_audio - 输入参数

<ParamField body="audio_url" type="string" required>
  **音频网址**，必须是公开可访问的链接，音频格式支持 `mp3` `wma` `wav` `aac` `m4a` `flac` 等。
</ParamField>

<ParamField body="draft_id" type="string" required>
  **草稿编码**，指定要添加到的草稿编码，一般来自于 `创建草稿 (create_draft)` 工具的输出参数。
</ParamField>

<ParamField body="timeline_start" type="number" required>
  **时间轴入场点**，音频在时间轴上开始播放的位置，单位 `秒`。
</ParamField>

<ParamField body="duration" type="number" required>
  **音频时长**，单位 `秒`，`-1` 表示取当前整个时间轴的时长。
</ParamField>

<ParamField body="cut_start" type="number">
  **音频裁剪起始位置**，设置音频片段在原始文件中的开始截取点。默认从 `0`（开头）开始，单位 `秒`。
</ParamField>

<ParamField body="cut_end" type="number">
  **音频裁剪结束位置**，设置音频片段在原始文件中的停止截取点，单位 `秒`。`cut_end` 应大于 `cut_start`。
</ParamField>

<ParamField body="volume" type="number">
  **声音大小**，范围 `0 ~ 1`，默认值 `1`。
</ParamField>

<ParamField body="speed" type="number">
  **播放速度**，默认 `1` 为原速，数值越大速度越快。
</ParamField>

<ParamField body="track_name" type="string">
  **目标轨道名称**，指定当前音频要插入的轨道名称，若轨道不存在会自动新建。
</ParamField>

### add\_audio - 输出参数

<ResponseField name="success" type="boolean">
  **是否执行成功**，`true` 成功，`false` 失败。
</ResponseField>

<ResponseField name="error" type="string">
  **错误信息**，如果没有执行成功，这里会显示错误信息，否则为空。
</ResponseField>

<ResponseField name="output" type="object">
  <Expandable title="查看 output 内部字段" defaultOpen>
    <ResponseField name="timeline_start" type="number">
      **时间轴入场点**，音频在时间轴上开始播放的位置，单位 `秒`。
    </ResponseField>

    <ResponseField name="timeline_end" type="number">
      **时间轴出场点**，音频在时间轴上结束播放的位置，单位 `秒`。
    </ResponseField>

    <ResponseField name="track_name" type="string">
      **所属轨道**，音频所在轨道的名称。
    </ResponseField>
  </Expandable>
</ResponseField>

## 添加视频 (add\_video)

用于向指定的剪映草稿中添加视频素材。

### add\_video - 输入参数

<ParamField body="video_url" type="string" required>
  **视频网址**，必须是公开可访问的链接，视频格式支持 `mp4` `mov` `avi` `wmv` `f4v` `m4v` `mpg` `mpeg4` `mkv` `flv` `rmvb` `mts` `m2ts` `m2t` `ts` `mxf` `webm` 等。
</ParamField>

<ParamField body="draft_id" type="string" required>
  **草稿编码**，指定要添加到的草稿编码，一般来自于 `创建草稿 (create_draft)` 工具的输出参数。
</ParamField>

<ParamField body="timeline_start" type="number" required>
  **时间轴入场点**，视频在时间轴上开始播放的位置，单位 `秒`。
</ParamField>

<ParamField body="duration" type="number" required>
  **视频时长**，视频在时间轴上播放的时间长度，单位 `秒`，`-1` 表示取当前整个时间轴的时长。
</ParamField>

<ParamField body="cut_start" type="number">
  **视频裁剪起始位置**，设置视频片段在原始文件中的开始截取点。默认从 `0`（开头）开始，单位 `秒`。
</ParamField>

<ParamField body="cut_end" type="number">
  **视频裁剪结束位置**，设置视频片段在原始文件中的停止截取点，单位 `秒`。`cut_end` 应大于 `cut_start`。
</ParamField>

<ParamField body="volume" type="number">
  **声音大小**，控制视频播放时的声音大小，范围 `0 ~ 1`，`1` 原始音量，`0` 静音，默认值 `1`。
</ParamField>

<ParamField body="speed" type="number">
  **播放速度**，控制视频在时间轴上的播放快慢，默认值 `1` 为原始速度，数值越大速度越快。
</ParamField>

<ParamField body="scale" type="number">
  **缩放比例**，控制视频在画面中的大小比例，默认值 `1` 为原始大小，`> 1` 为放大，`< 1` 为缩小。
</ParamField>

<ParamField body="transform_x" type="number">
  **X轴位置**，范围 `-1 ~ 1`，`0` 水平居中，`-1` 画面最左侧，`1` 画面最右侧，默认值 `0`。
</ParamField>

<ParamField body="transform_y" type="number">
  **Y轴位置**，范围 `-1 ~ 1`，`0` 垂直居中，`-1` 画面底端，`1` 画面顶端，默认值 `0`。
</ParamField>

<ParamField body="relative_index" type="integer">
  **层级关系**，用于控制多个素材在空间位置上重叠时，谁在上层，谁在下层。数值越高越接近前景，默认值 `0`。
</ParamField>

<ParamField body="transition" type="string">
  **转场效果**，设置当前素材要使用的转场的名称。

  插件支持哪些转场？请参考本页的 \[ [转场 快查表](#转场-快查表) ] 部分。
</ParamField>

<ParamField body="transition_duration" type="number">
  **转场时长**，控制转场展示的时间长度，单位 `秒`，必须先设置 `transition` 参数。
</ParamField>

<ParamField body="track_name" type="string">
  **目标轨道名称**，指定当前视频要插入的轨道名称，若轨道不存在会自动新建。
</ParamField>

### add\_video - 输出参数

<ResponseField name="success" type="boolean">
  **是否执行成功**，`true` 成功，`false` 失败。
</ResponseField>

<ResponseField name="error" type="string">
  **错误信息**，如果没有执行成功，这里会显示错误信息，否则为空。
</ResponseField>

<ResponseField name="output" type="object">
  <Expandable title="查看 output 内部字段" defaultOpen>
    <ResponseField name="timeline_start" type="number">
      **时间轴入场点**，视频在时间轴上开始播放的位置，单位 `秒`。
    </ResponseField>

    <ResponseField name="timeline_end" type="number">
      **时间轴出场点**，视频在时间轴上结束播放的位置，单位 `秒`。
    </ResponseField>

    <ResponseField name="track_name" type="string">
      **所属轨道**，视频所在轨道的名称。
    </ResponseField>
  </Expandable>
</ResponseField>

## 添加图片 (add\_image)

用于向指定的剪映草稿中添加图片素材。

### add\_image - 输入参数

<ParamField body="image_url" type="string" required>
  **图片网址**，必须是公开可访问的链接，图片格式支持 `jpeg` `png` `gif` `bmp` `webp` 等。
</ParamField>

<ParamField body="draft_id" type="string" required>
  **草稿编码**，指定要添加到的草稿编码，一般来自于 `创建草稿 (create_draft)` 工具的输出参数。
</ParamField>

<ParamField body="timeline_start" type="number" required>
  **时间轴入场点**，图片在时间轴上开始显示的位置，单位 `秒`。
</ParamField>

<ParamField body="timeline_end" type="number">
  **时间轴出场点**，图片在时间轴上结束显示的位置，默认值 `3`，单位 `秒`，`-1` 表示取当前整个时间轴的结束位置。`timeline_end` 应大于 `timeline_start`
</ParamField>

<ParamField body="scale" type="number">
  **缩放比例**，控制图片在画面中的大小比例，默认值 `1` 为原始大小，`> 1` 为放大，`< 1` 为缩小。
</ParamField>

<ParamField body="transform_x" type="number">
  **X轴位置**，范围 `-1 ~ 1`，`0` 水平居中，`-1` 画面最左侧，`1` 画面最右侧，默认值 `0`。
</ParamField>

<ParamField body="transform_y" type="number">
  **Y轴位置**，范围 `-1 ~ 1`，`0` 垂直居中，`-1` 画面底端，`1` 画面顶端，默认值 `0`。
</ParamField>

<ParamField body="relative_index" type="integer">
  **层级关系**，用于控制多个素材在空间位置上重叠时，谁在上层，谁在下层。数值越高越接近前景，默认值 `0`。
</ParamField>

<ParamField body="transition" type="string">
  **转场效果**，设置当前素材要使用的转场的名称。

  插件支持哪些转场？请参考本页的 \[ [转场 快查表](#转场-快查表) ] 部分。
</ParamField>

<ParamField body="transition_duration" type="number">
  **转场时长**，控制转场展示的时间长度，单位 `秒`，必须先设置 `transition` 参数。
</ParamField>

<ParamField body="intro_animation" type="string">
  **入场动画**，设置当前素材要使用的入场动画的名称。

  插件支持哪些入场动画？请参考本页的 \[ [入场动画 快查表](#入场动画-快查表) ] 部分。
</ParamField>

<ParamField body="intro_animation_duration" type="number">
  **入场动画时长**，控制入场动画展示的时间长度，单位 `秒`，必须先设置 `intro_animation` 参数。
</ParamField>

<ParamField body="outro_animation" type="string">
  **出场动画**，设置当前素材要使用的出场动画的名称。

  插件支持哪些出场动画？请参考本页的 \[ [出场动画 快查表](#出场动画-快查表) ] 部分。
</ParamField>

<ParamField body="outro_animation_duration" type="number">
  **出场动画时长**，控制出场动画展示的时间长度，单位 `秒`，必须先设置 `outro_animation` 参数。
</ParamField>

<ParamField body="track_name" type="string">
  **目标轨道名称**，指定当前图片要插入的轨道名称，若轨道不存在会自动新建。
</ParamField>

### add\_image - 输出参数

<ResponseField name="success" type="boolean">
  **是否执行成功**，`true` 成功，`false` 失败。
</ResponseField>

<ResponseField name="error" type="string">
  **错误信息**，如果没有执行成功，这里会显示错误信息，否则为空。
</ResponseField>

<ResponseField name="output" type="object">
  <Expandable title="查看 output 内部字段" defaultOpen>
    <ResponseField name="timeline_start" type="number">
      **时间轴入场点**，图片在时间轴上开始显示的位置，单位 `秒`。
    </ResponseField>

    <ResponseField name="timeline_end" type="number">
      **时间轴出场点**，图片在时间轴上结束显示的位置，单位 `秒`。
    </ResponseField>

    <ResponseField name="track_name" type="string">
      **所属轨道**，图片所在轨道的名称。
    </ResponseField>
  </Expandable>
</ResponseField>

## 添加文字 (add\_text)

用于向指定的剪映草稿中添加文字素材。

### add\_text - 输入参数

<ParamField body="text" type="string" required>
  **文本内容**，设置要添加的文本内容。
</ParamField>

<ParamField body="draft_id" type="string" required>
  **草稿编码**，指定要添加到的草稿编码，一般来自于 `创建草稿 (create_draft)` 工具的输出参数。
</ParamField>

<ParamField body="timeline_start" type="number" required>
  **时间轴入场点**，文本在时间轴上开始显示的位置，单位 `秒`。
</ParamField>

<ParamField body="timeline_end" type="number">
  **时间轴出场点**，文本在时间轴上结束显示的位置，默认值 `3`，单位 `秒`，`-1` 表示取当前整个时间轴的结束位置。`timeline_end` 应大于 `timeline_start`
</ParamField>

<ParamField body="time_offset" type="number">
  **时间偏移量**，用于微调文本出现的时间，解决音画不同步问题，单位 `秒`。`正值` 延迟出现，`负值` 提前出现
</ParamField>

<ParamField body="font" type="string">
  **字体**，设置文本显示的字体样式，默认值 `抖音美好体`。

  插件支持哪些字体？请参考本页的 \[ [字体 快查表](#字体-快查表) ] 部分。
</ParamField>

<ParamField body="font_size" type="integer">
  **字号**，用于设置文本字体显示的大小，默认值 `8`。
</ParamField>

<ParamField body="font_color" type="string">
  **文字颜色**，格式为标准十六进制颜色代码，默认值 `#ffffff`。
</ParamField>

<ParamField body="font_alpha" type="number">
  **文字透明度**，范围 `0 ~ 1`，`0` 完全透明，`1` 不透明，默认值 `0`。
</ParamField>

<ParamField body="border_width" type="integer">
  **文字描边粗细**，用于增强文字在复杂背景下的可读性，默认值 `0` 表示无描边。
</ParamField>

<ParamField body="border_color" type="string">
  **文字描边颜色**，格式为标准十六进制颜色代码，例如 `#000000`。
</ParamField>

<ParamField body="background_alpha" type="number">
  **文字背景透明度**，范围 `0 ~ 1`，`0` 完全透明，`1` 不透明，默认值 `0`。
</ParamField>

<ParamField body="background_color" type="string">
  **文字背景颜色**，衬托于文字之下的色块，格式为标准十六进制颜色代码，例如 `#ffff00`。
</ParamField>

<ParamField body="background_round_radius" type="number">
  **文字背景圆角半径**，用于调整文字背景色块四个角的圆润程度，范围 `0 ~ 1`。
</ParamField>

<ParamField body="background_width" type="number">
  **文字背景左右边距**，用于控制背景色块在文字左右两侧的延伸长度，范围 `0 ~ 1`。
</ParamField>

<ParamField body="background_height" type="number">
  **文字背景上下边距**，用于控制背景色块在文字上下两端的延伸高度，范围 `0 ~ 1`。
</ParamField>

<ParamField body="line_spacing" type="integer">
  **文字行间距**，用于控制多行文本之间的垂直间隔距离。
</ParamField>

<ParamField body="vertical" type="boolean">
  **开启纵向排列**，决定文本的排版方向是水平（横排）还是垂直（竖排），默认值 `false`。
</ParamField>

<ParamField body="fixed_width" type="number">
  **文本框固定宽度比例**，文本框相对屏幕的最大宽度比例，范围 `0 ~ 1`，`-1` 表示不限制，默认值 `0.5`。
</ParamField>

<ParamField body="fixed_height" type="number">
  **文本框固定高度比例**，文本框相对屏幕的最大高度比例，范围 `0 ~ 1`，`-1` 表示不限制，默认值 `-1`。
</ParamField>

<ParamField body="transform_x" type="number">
  **X轴位置**，范围 `-1 ~ 1`，`0` 水平居中，`-1` 画面最左侧，`1` 画面最右侧，默认值 `0`。
</ParamField>

<ParamField body="transform_y" type="number">
  **Y轴位置**，范围 `-1 ~ 1`，`0` 垂直居中，`-1` 画面底端，`1` 画面顶端，默认值 `0`。
</ParamField>

<ParamField body="intro_animation" type="string">
  **入场动画**，设置当前素材要使用的入场动画的名称。

  插件支持哪些入场动画？请参考本页的 \[ [入场动画 快查表](#入场动画-快查表) ] 部分。
</ParamField>

<ParamField body="intro_animation_duration" type="number">
  **入场动画时长**，控制入场动画展示的时间长度，单位 `秒`，必须先设置 `intro_animation` 参数。
</ParamField>

<ParamField body="outro_animation" type="string">
  **出场动画**，设置当前素材要使用的出场动画的名称。

  插件支持哪些出场动画？请参考本页的 \[ [出场动画 快查表](#出场动画-快查表) ] 部分。
</ParamField>

<ParamField body="outro_animation_duration" type="number">
  **出场动画时长**，控制出场动画展示的时间长度，单位 `秒`，必须先设置 `outro_animation` 参数。
</ParamField>

<ParamField body="track_name" type="string">
  **目标轨道名称**，指定当前文本要插入的轨道名称，若轨道不存在会自动新建。
</ParamField>

### add\_text - 输出参数

<ResponseField name="success" type="boolean">
  **是否执行成功**，`true` 成功，`false` 失败。
</ResponseField>

<ResponseField name="error" type="string">
  **错误信息**，如果没有执行成功，这里会显示错误信息，否则为空。
</ResponseField>

<ResponseField name="output" type="object">
  <Expandable title="查看 output 内部字段" defaultOpen>
    <ResponseField name="timeline_start" type="number">
      **时间轴入场点**，文本在时间轴上开始显示的位置，单位 `秒`。
    </ResponseField>

    <ResponseField name="timeline_end" type="number">
      **时间轴出场点**，文本在时间轴上结束显示的位置，单位 `秒`。
    </ResponseField>

    <ResponseField name="track_name" type="string">
      **所属轨道**，文本所在轨道的名称。
    </ResponseField>
  </Expandable>
</ResponseField>

## 添加关键帧 (add\_keyframe)

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

### add\_keyframe - 输入参数

<Warning>
  在关键帧的输入参数中包含 `单帧` 和 `多帧` 两套方案，这两套方案不能同时使用。

  使用 `单帧` 方案每次只能添加 1 个关键帧，而 `多帧` 方案可以用数组的形式一次性添加多个关键帧。
</Warning>

<ParamField body="draft_id" type="string" required>
  **草稿编码**，指定要添加到的草稿编码，一般来自于 `创建草稿 (create_draft)` 工具的输出参数。
</ParamField>

<ParamField body="kf_property" type="string">
  **关键帧属性名称（单帧）**，指定单个关键帧作用的动画属性名称。

  插件支持哪些关键帧属性？请参考本页的 \[ [关键帧属性 快查表](#关键帧属性-快查表) ] 部分。
</ParamField>

<ParamField body="kf_value" type="string">
  **关键帧属性值（单帧）**，设置单个键帧作用的动画属性值。
</ParamField>

<ParamField body="kf_time_point" type="number">
  **关键帧时间点（单帧）**，设置添加单个关键帧的时间点，单位 `秒`。
</ParamField>

<ParamField body="kf_time_offset" type="number">
  **关键帧时间点偏移量（单帧）**，可在毫秒级尺度上微调单个关键帧时间点，以避免重合失效，单位 `秒`。
</ParamField>

<ParamField body="kfs_propertys" type="array<string>">
  **关键帧属性名称列表（多帧）**，指定一组关键帧作用的多个动画属性名称。

  输入示例（同时控制旋转和缩放的复合动画）：

  `["rotation", "rotation", "uniform_scale", "uniform_scale"]`

  插件支持哪些关键帧属性？请参考本页的 \[ [关键帧属性 快查表](#关键帧属性-快查表) ] 部分。
</ParamField>

<ParamField body="kfs_values" type="array<string>">
  **关键帧属性值列表（多帧）**，设置一组关键帧作用的多个动画属性值，数量必须与 `kfs_propertys` 中数量一致。

  输入示例（同时设置旋转和缩放动画的起始和结束帧的数值）：

  `["0", "30", "0.47", "0.7"]`
</ParamField>

<ParamField body="kfs_time_points" type="array<number>">
  **关键帧时间点列表（多帧）**，设置添加多个关键帧的时间点，数量必须与 `kfs_propertys` 中数量一致。

  输入示例（同时设置旋转和缩放动画的起始和结束帧的时间点）：

  `[1.53, 3, 1.53, 3]`
</ParamField>

<ParamField body="track_name" type="string">
  **目标轨道名称**，指定当前关键帧或关键帧列表要插入的轨道名称，若轨道不存在会自动新建。
</ParamField>

### add\_keyframe - 输出参数

<ResponseField name="success" type="boolean">
  **是否执行成功**，`true` 成功，`false` 失败。
</ResponseField>

<ResponseField name="error" type="string">
  **错误信息**，如果没有执行成功，这里会显示错误信息，否则为空。
</ResponseField>

<ResponseField name="output" type="object">
  <Expandable title="查看 output 内部字段" defaultOpen>
    <ResponseField name="added_count" type="integer">
      **添加关键帧的数量**，用于统计本次添加了多少个关键帧。
    </ResponseField>
  </Expandable>
</ResponseField>

## 添加特效 (add\_effect)

用于向指定的剪映草稿中添加文字素材。

### add\_effect - 输入参数

<ParamField body="effect_name" type="string" required>
  **特效名称**，设置要添加的特效名称。

  插件支持哪些特效？请参考本页的 \[ [特效 快查表](#特效-快查表) ] 部分。
</ParamField>

<ParamField body="draft_id" type="string" required>
  **草稿编码**，指定要添加到的草稿编码，一般来自于 `创建草稿 (create_draft)` 工具的输出参数。
</ParamField>

<ParamField body="timeline_start" type="number" required>
  **时间轴入场点**，特效在时间轴上开始显示的位置，单位 `秒`。
</ParamField>

<ParamField body="timeline_end" type="number">
  **时间轴出场点**，特效在时间轴上结束显示的位置，默认值 `3`，单位 `秒`，`-1` 表示取当前整个时间轴的结束位置。`timeline_end` 应大于 `timeline_start`
</ParamField>

<ParamField body="track_name" type="string">
  **目标轨道名称**，指定当前特效要插入的轨道名称，若轨道不存在会自动新建。
</ParamField>

### add\_effect - 输出参数

<ResponseField name="success" type="boolean">
  **是否执行成功**，`true` 成功，`false` 失败。
</ResponseField>

<ResponseField name="error" type="string">
  **错误信息**，如果没有执行成功，这里会显示错误信息，否则为空。
</ResponseField>

<ResponseField name="output" type="object">
  <Expandable title="查看 output 内部字段" defaultOpen>
    <ResponseField name="timeline_start" type="number">
      **时间轴入场点**，特效在时间轴上开始显示的位置，单位 `秒`。
    </ResponseField>

    <ResponseField name="timeline_end" type="number">
      **时间轴出场点**，特效在时间轴上结束显示的位置，单位 `秒`。
    </ResponseField>

    <ResponseField name="track_name" type="string">
      **所属轨道**，特效所在轨道的名称。
    </ResponseField>
  </Expandable>
</ResponseField>

## 添加贴纸 (add\_sticker)

用于向指定的剪映草稿中添加贴纸素材。

### add\_sticker - 输入参数

<ParamField body="sticker_id" type="string" required>
  **贴纸编码**，设置要添加的贴纸编码。

  如何获得贴纸编码？需要先在剪映的任意测试草稿中手动添加想要的贴纸，然后从该草稿的工程文件中，找到对应的贴纸编码并记录下来。
</ParamField>

<ParamField body="draft_id" type="string" required>
  **草稿编码**，指定要添加到的草稿编码，一般来自于 `创建草稿 (create_draft)` 工具的输出参数。
</ParamField>

<ParamField body="timeline_start" type="number" required>
  **时间轴入场点**，贴纸在时间轴上开始显示的位置，单位 `秒`。
</ParamField>

<ParamField body="timeline_end" type="number">
  **时间轴出场点**，贴纸在时间轴上结束显示的位置，默认值 `3`，单位 `秒`，`-1` 表示取当前整个时间轴的结束位置。`timeline_end` 应大于 `timeline_start`
</ParamField>

<ParamField body="scale" type="number">
  **缩放比例**，控制贴纸在画面中的大小比例，默认值 `1` 为原始大小，`> 1` 为放大，`< 1` 为缩小。
</ParamField>

<ParamField body="transform_x" type="number">
  **X轴位置**，范围 `-1 ~ 1`，`0` 水平居中，`-1` 画面最左侧，`1` 画面最右侧，默认值 `0`。
</ParamField>

<ParamField body="transform_y" type="number">
  **Y轴位置**，范围 `-1 ~ 1`，`0` 垂直居中，`-1` 画面底端，`1` 画面顶端，默认值 `0`。
</ParamField>

<ParamField body="rotation" type="number">
  **旋转角度**，顺时针旋转，可正可负，单位 `度`，默认值 `0`。
</ParamField>

<ParamField body="alpha" type="number">
  **透明度**，范围 `0 ~ 1`，`0` 完全透明，`1` 不透明，默认值 `1`。
</ParamField>

<ParamField body="relative_index" type="integer">
  **层级关系**，用于控制多个素材在空间位置上重叠时，谁在上层，谁在下层。数值越高越接近前景，默认值 `0`。
</ParamField>

<ParamField body="track_name" type="string">
  **目标轨道名称**，指定当前贴纸要插入的轨道名称，若轨道不存在会自动新建。
</ParamField>

### add\_sticker - 输出参数

<ResponseField name="success" type="boolean">
  **是否执行成功**，`true` 成功，`false` 失败。
</ResponseField>

<ResponseField name="error" type="string">
  **错误信息**，如果没有执行成功，这里会显示错误信息，否则为空。
</ResponseField>

<ResponseField name="output" type="object">
  <Expandable title="查看 output 内部字段" defaultOpen>
    <ResponseField name="timeline_start" type="number">
      **时间轴入场点**，贴纸在时间轴上开始显示的位置，单位 `秒`。
    </ResponseField>

    <ResponseField name="timeline_end" type="number">
      **时间轴出场点**，贴纸在时间轴上结束显示的位置，单位 `秒`。
    </ResponseField>

    <ResponseField name="track_name" type="string">
      **所属轨道**，贴纸所在轨道的名称。
    </ResponseField>
  </Expandable>
</ResponseField>

## 资源参考附录

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

### 字体 快查表

您可以在本表中快速查找：字体名称。

<Tip>
  当使用插件中的 `font` 参数时，填写表中的 `字体名称` 即可。
</Tip>

| **字体名称**                     |                             |                              |
| :--------------------------- | :-------------------------- | :--------------------------- |
| 今宋体                          | 后现代体                        | 以梦为马                         |
| 优设好身体                        | 优设标题圆                       | 优设标题黑                        |
| 俊雅体                          | 元气泡泡体                       | 元瑶体                          |
| 先锋体                          | 兰亭圆                         | 凌东齐伋体\_combo                 |
| 凌东齐伋体\_fallback              | 匹喏曹                         | 半梦体                          |
| 卡酷体                          | 古典体                         | 古印宋简                         |
| 古雅体                          | 古风小楷                        | 台北黑体\_Light                  |
| 台北黑体\_Regular                | 仓耳周珂正大榜书                    | 喜悦体                          |
| 嘉木体                          | 圆体                          | 基础像素                         |
| 墩墩体                          | 大字报                         | 大梁体                          |
| 妙黑体                          | 字制区喜脉体                      | 孤月体                          |
| 宋体                           | 小薇体                         | 尔雅新大黑                        |
| 峰骨体                          | 幼萱体                         | 得意黑                          |
| 快乐体                          | 快速体                         | 思源中宋                         |
| 思源粗宋                         | 悠悠然                         | 悦妍体                          |
| 惊鸿体                          | 抖音美好体                       | 招牌体                          |
| 挥墨体                          | 文研体                         | 文艺繁体                         |
| 文轩体                          | 文雅体                         | 新青年体                         |
| 方糖体                          | 无界黑                         | 日式标题                         |
| 星光体                          | 有猫在                         | 李李体                          |
| 极简拼音                         | 梅雨煎茶                        | 梦桃体                          |
| 楚辰体                          | 欣然体                         | 毡笔体                          |
| 汇文明朝体                        | 汉仪英雄体                       | 江户招牌                         |
| 江湖体                          | 油漆体                         | 海岛森林\_全字符                    |
| 清刻本悦                         | 温柔体                         | 港风繁体                         |
| 游园体                          | 漫语体                         | 点宋体                          |
| 烈金体                          | 烟波宋                         | 特黑体                          |
| 琉璃宋                          | 瑞意宋                         | 瑶蝶体                          |
| 甜甜圈                          | 目光体                         | 真言体                          |
| 研宋体                          | 禅影体                         | 童趣体                          |
| 简中圆                          | 糯米团                         | 纯真体                          |
| 细体                           | 经典雅黑                        | 综艺字                          |
| 美佳体                          | 聚珍体                         | 中秀体                          |
| 若烟体                          | 荔枝体                         | 萌趣体                          |
| 蒹葭体                          | 薯条少年                        | 蝉影隶书                         |
| 装甲明朝                         | 谷秋体                         | 超重要体                         |
| 轻吟体                          | 追光体                         | 逸致拼音                         |
| 金陵体                          | 锦瑟体                         | 雁兰体                          |
| 雅酷黑简                         | 霸燃手书                        | 青松体                          |
| 风雅宋                          | 飒爽手写                        | 飞扬行书                         |
| 飞驰体                          | 高字标志黑                       | 高字湘黑体                        |
| 黄令东齐伋复刻体                     | 黄金时代                        | 黑糖体                          |
| 默陌手写                         | 芋圆体                         | 一笔壹画加油体                      |
| 아기                           | ｾﾘﾌ太字                       |                              |
| CC\_Captial                  | CC\_Moderno                 | JYruantang                   |
| JYshiduo                     | JYzhuqingting               | Merry\_Christmas             |
| MyFont凌渡哥哥简                  | ZY\_Balloonbillow           | ZY\_Blossom                  |
| ZY\_Brief                    | ZY\_Courage                 | ZY\_Daisy                    |
| ZY\_Elixir                   | ZY\_Fabulous                | ZY\_Fantasy                  |
| ZY\_Flourishing\_Italic      | ZY\_Fortitude               | ZY\_Kindly\_Breeze           |
| ZY\_Loyalty                  | ZY\_Modern                  | ZY\_Multiplicity             |
| ZY\_Panacea                  | ZY\_Relax                   | ZY\_Slender                  |
| ZY\_Spunk                    | ZY\_Squiggle                | ZY\_Starry                   |
| ZY\_Timing                   | ZY\_Trend                   | ZYLAA\_Demure                |
| Amigate                      | Anson                       | BlackMango\_Black            |
| BlackMango\_Regular          | Bungee\_Regular             | Cabin\_Rg                    |
| Caveat\_Regular              | Climate                     | Coiny\_Regular               |
| DMSans\_BoldItalic           | Exo                         | Gallery                      |
| Giveny                       | Grandstander\_Regular       | Gratefulness                 |
| HarmonyOS\_Sans\_SC\_Bold    | HarmonyOS\_Sans\_SC\_Medium | HarmonyOS\_Sans\_SC\_Regular |
| HarmonyOS\_Sans\_TC\_Bold    | HarmonyOS\_Sans\_TC\_Light  | HarmonyOS\_Sans\_TC\_Medium  |
| HarmonyOS\_Sans\_TC\_Regular | HeptaSlab\_ExtraBold        | HeptaSlab\_Light             |
| Huben                        | Ingram                      | Integrity                    |
| Inter\_Black                 | Kanit\_Black                | Kanit\_Regular               |
| Koulen\_Regular              | LXGWWenKai\_Bold            | LXGWWenKai\_Light            |
| LXGWWenKai\_Regular          | Love                        | Luxury                       |
| MiSans\_Heavy                | MiSans\_Regular             | Modern                       |
| Nunito                       | OldStandardTT\_Regular      | Pacifico\_Regular            |
| PlayfairDisplay\_Bold        | Plunct                      | Polly                        |
| Poppins\_Bold                | Poppins\_Regular            | RedHatDisplay\_BoldItalic    |
| RedHatDisplay\_Light         | ResourceHanRoundedCN\_Md    | ResourceHanRoundedCN\_Nl     |
| Roboto\_BlkCn                | SansitaSwashed\_Regular     | SecularOne\_Regular          |
| Signature                    | Soap                        | Sora\_Bold                   |
| Sora\_Regular                | SourceHanSansCN\_Bold       | SourceHanSansCN\_Light       |
| SourceHanSansCN\_Medium      | SourceHanSansCN\_Normal     | SourceHanSansCN\_Regular     |
| SourceHanSansTW\_Bold        | SourceHanSansTW\_Light      | SourceHanSansTW\_Medium      |
| SourceHanSansTW\_Normal      | SourceHanSansTW\_Regular    | SourceHanSerifCN\_Light      |
| SourceHanSerifCN\_Medium     | SourceHanSerifCN\_Regular   | SourceHanSerifCN\_SemiBold   |
| SourceHanSerifTW\_Bold       | SourceHanSerifTW\_Light     | SourceHanSerifTW\_Medium     |
| SourceHanSerifTW\_Regular    | SourceHanSerifTW\_SemiBold  | Staatliches\_Regular         |
| Sunset                       | Thrive                      | Thunder                      |
| Tronica                      | Vintage                     | ZY\_Dexterous                |
| ZY\_Earnest                  | ZY\_Vigorous                | ZY\_Vigorous\_Medium         |
| ZYLantastic                  | ZYLullaby                   | ZYSilhouette                 |
| ZYWitty                      | Zapfino                     |                              |

### 转场 快查表

您可以在本表中快速查找：转场效果名称 (默认时长)。

<Tip>
  当使用插件中的 `transition` 参数时，填写表中的 `转场效果名称` 即可。
</Tip>

| **转场效果名称**       |                  |                   |                   |
| :--------------- | :--------------- | :---------------- | :---------------- |
| 3D空间 (1.50s)     | 上移 (0.50s)       | 下移 (0.50s)        | 中心旋转 (0.50s)      |
| 云朵 (0.50s)       | 倒影 (0.50s)       | 冰雪结晶 (0.50s)      | 冲鸭 (0.50s)        |
| 分割 (0.50s)       | 分割\_II (0.50s)   | 分割\_III (0.50s)   | 分割\_IV (0.50s)    |
| 前后对比\_II (0.80s) | 动漫云朵 (0.50s)     | 动漫漩涡 (0.50s)      | 动漫火焰 (0.50s)      |
| 动漫闪电 (0.50s)     | 压缩 (0.50s)       | 叠加 (1.00s)        | 叠化 (0.50s)        |
| 右移 (1.00s)       | 向上 (1.00s)       | 向上擦除 (0.50s)      | 向下 (1.00s)        |
| 向下擦除 (0.50s)     | 向下流动 (0.50s)     | 向右 (1.00s)        | 向右上 (0.50s)       |
| 向右下 (0.50s)      | 向右拉伸 (0.50s)     | 向右擦除 (0.50s)      | 向右流动 (0.50s)      |
| 向左 (0.50s)       | 向左上 (0.50s)      | 向左下 (0.50s)       | 向左拉伸 (0.50s)      |
| 向左擦除 (0.50s)     | 吸入 (1.00s)       | 回忆下滑 (1.00s)      | 圆形分割\_II (0.80s)  |
| 圆形扫描 (1.00s)     | 圆形遮罩 (0.50s)     | 圆形遮罩\_II (1.00s)  | 复古放映 (0.60s)      |
| 岁月的痕迹 (1.00s)    | 左下角\_II (0.70s)  | 左移 (1.00s)        | 开幕 (0.50s)        |
| 弹幕转场 (4.00s)     | 弹跳 (0.50s)       | 打板转场\_I (4.00s)   | 打板转场\_II (4.00s)  |
| 抖动 (0.80s)       | 抖动\_II (0.80s)   | 抠像旋转 (0.80s)      | 拉伸 (1.20s)        |
| 拉伸\_II (0.60s)   | 拉远 (1.00s)       | 拍摄器 (0.50s)       | 推近 (1.00s)        |
| 撕纸拉屏 (0.70s)     | 放射 (1.00s)       | 故障 (1.00s)        | 斜向分割 (0.50s)      |
| 星星 (0.50s)       | 星星\_II (0.50s)   | 模糊 (0.50s)        | 横向分割 (0.50s)      |
| 横向拉幕 (1.00s)     | 横线 (0.50s)       | 气泡转场 (4.00s)      | 水波卷动 (0.50s)      |
| 水波向右 (0.50s)     | 水波向左 (0.50s)     | 泛光 (1.00s)        | 泛白 (1.00s)        |
| 波点向右 (0.50s)     | 渐变擦除 (1.00s)     | 滑动 (1.00s)        | 漩涡 (1.00s)        |
| 爱心 (0.50s)       | 爱心\_II (0.50s)   | 爱心上升 (0.50s)      | 电视故障\_I (1.60s)   |
| 电视故障\_II (1.60s) | 画笔擦除 (0.50s)     | 白光快闪 (0.40s)      | 白色墨花 (0.50s)      |
| 白色烟雾 (0.50s)     | 百叶窗 (0.50s)      | 眨眼 (0.50s)        | 矩形分割 (0.50s)      |
| 窗格 (0.50s)       | 立方体 (0.50s)      | 竖向分割 (0.50s)      | 竖向拉幕 (1.00s)      |
| 竖向模糊 (0.80s)     | 竖向模糊\_II (0.66s) | 竖线 (0.50s)        | 箭头向右 (0.50s)      |
| 粒子 (0.50s)       | 翻篇 (1.30s)       | 翻页 (0.50s)        | 色差逆时针 (1.00s)     |
| 色差顺时针 (1.00s)    | 色彩溶解 (0.50s)     | 色彩溶解\_II (1.00s)  | 色彩溶解\_III (1.00s) |
| 蓝色线条 (0.50s)     | 逆时针旋转 (0.50s)    | 逆时针旋转\_II (0.80s) | 镜像翻转 (1.00s)      |
| 闪白 (0.50s)       | 闪白\_II (0.30s)   | 闪黑 (0.50s)        | 雪花故障 (1.00s)      |
| 雾化 (1.20s)       | 震动 (1.00s)       | 顺时针旋转 (0.50s)     | 顺时针旋转\_II (0.80s) |
| 频闪 (0.50s)       | 风车 (0.50s)       | 马赛克 (1.00s)       | 黑色块 (0.50s)       |
| 黑色烟雾 (0.50s)     | 万花筒 (0.80s)      | 三屏放大 (1.00s)      | 三屏滑入 (1.00s)      |
| 三屏闪切 (0.80s)     | 下滑 (0.55s)       | 云朵\_II (0.50s)    | 亮点模糊 (1.00s)      |
| 便利贴 (1.10s)      | 信号故障 (0.50s)     | 信号故障\_II (0.67s)  | 倾斜拉伸 (0.80s)      |
| 倾斜模糊 (0.80s)     | 像素冲屏 (0.80s)     | 光束 (0.50s)        | 全息投影 (0.40s)      |
| 六边形变焦 (1.00s)    | 冲屏扭曲 (0.90s)     | 几何分割 (0.50s)      | 分屏下滑 (0.90s)      |
| 前后对比 (1.20s)     | 剧烈摇晃 (0.90s)     | 卡片弹出 (1.00s)      | 可爱爆炸 (0.80s)      |
| 吃掉 (0.90s)       | 后台切换 (0.80s)     | 向上波动 (5.00s)      | 向下抖动 (1.30s)      |
| 向下拖拽 (0.80s)     | 向左拉屏 (0.50s)     | 向左波动 (5.00s)      | 喜欢 (0.50s)        |
| 四屏转换 (1.00s)     | 回忆 (0.50s)       | 回忆\_II (0.50s)    | 回忆拉屏 (1.00s)      |
| 回忆拉屏\_II (0.70s) | 圆形分割 (1.50s)     | 圣诞树 (0.70s)       | 复古叠影 (1.00s)      |
| 复古放映\_II (1.00s) | 复古漏光 (0.80s)     | 复古漏光\_II (0.60s)  | 复古胶片 (1.00s)      |
| 多层环形 (1.50s)     | 多屏定格 (0.80s)     | 大圆盘 (0.80s)       | 射灯 (1.60s)        |
| 小喇叭 (0.50s)      | 小恶魔 (1.00s)      | 幻影 (0.80s)        | 幻觉 (1.00s)        |
| 开心 (0.50s)       | 弹出 (0.90s)       | 弹动发光 (0.80s)      | 彩色像素 (0.50s)      |
| 微抖动 (1.50s)      | 心形叠化 (1.00s)     | 快速缩放 (1.00s)      | 快门 (0.50s)        |
| 扫光 (0.50s)       | 扭曲溶解 (1.00s)     | 扭转弹动 (1.50s)      | 抖动放大 (0.80s)      |
| 抖动缩小 (0.70s)     | 抖动缩小\_II (1.00s) | 抽象前景 (0.50s)      | 抽象前景\_II (0.50s)  |
| 拉开 (0.60s)       | 拉框入屏 (1.00s)     | 拍摄器\_II (0.90s)   | 拍摄器\_III (0.80s)  |
| 推近\_II (0.90s)   | 推远\_II (1.00s)   | 摄像机 (0.50s)       | 摇晃描边 (1.00s)      |
| 摇晃震动 (1.30s)     | 摇镜 (0.70s)       | 撕纸 (0.50s)        | 撕纸掉落 (1.20s)      |
| 收缩抖动 (1.00s)     | 放大左移 (1.30s)     | 放大镜 (0.70s)       |                   |

### 入场动画 快查表

您可以在本表中快速查找：入场动画名称 (默认时长)。

<Tip>
  当使用插件中的 `intro_animation` 参数时，填写表中的 `入场动画名称` 即可。
</Tip>

| **入场动画名称**       |                   |                 |                |
| :--------------- | :---------------- | :-------------- | :------------- |
| 缩小 (0.50s)       | 渐显 (0.50s)        | 放大 (0.50s)      | 旋转 (0.50s)     |
| Kira游动 (2.27s)   | 抖动下降 (0.50s)      | 镜像翻转 (0.50s)    | 旋转开幕 (1.00s)   |
| 折叠开幕 (1.50s)     | 漩涡旋转 (0.50s)      | 跳转开幕 (0.73s)    | 轻微抖动 (0.50s)   |
| 轻微抖动\_II (0.50s) | 轻微抖动\_III (0.50s) | 上下抖动 (0.50s)    | 左右抖动 (0.50s)   |
| 斜切 (0.70s)       | 钟摆 (0.50s)        | 雨刷 (0.50s)      | 雨刷\_II (0.50s) |
| 向上转入 (0.50s)     | 向上转入\_II (0.50s)  | 向左转入 (0.50s)    | 向右转入 (0.50s)   |
| 向上滑动 (0.50s)     | 向下滑动 (0.50s)      | 向左滑动 (0.50s)    | 向右滑动 (0.50s)   |
| 向下甩入 (0.50s)     | 向右甩入 (0.50s)      | 向左上甩入 (0.50s)   | 向右上甩入 (0.50s)  |
| 向左下甩入 (0.50s)    | 向右下甩入 (0.50s)     | 动感放大 (0.50s)    | 动感缩小 (0.50s)   |
| 轻微放大 (0.50s)     |                   |                 |                |
| 快速翻页 (0.17s)     | 荧光爆闪 (1.00s)      | 十字震动 (0.80s)    | 爱心碰撞 (2.67s)   |
| 冲撞 (2.00s)       | 闪屏 (1.20s)        | 扫描 (0.60s)      | 震动波纹 (1.50s)   |
| 分屏翻转 (0.70s)     | 立体翻转 (1.10s)      | 马赛克 (1.00s)     | \_2024 (1.50s) |
| 多层环形 (2.00s)     | 弹力分割 (1.06s)      | 弹近 (1.50s)      | 画出爱心 (1.60s)   |
| 发光矩形 (1.03s)     | 空间扭曲 (1.16s)      | 四屏转换 (1.00s)    | 展开 (0.50s)     |
| 划水 (0.80s)       | 色散波纹 (0.83s)      | 模糊聚焦 (1.20s)    | 圆形开幕 (0.90s)   |
| 聚合 (2.00s)       | 砸出波纹 (1.56s)      | 向下甩动 (1.40s)    | 向上滚动 (1.00s)   |
| 拼图 (1.07s)       | 向上闪入 (0.70s)      | 交错开幕 (1.10s)    | 便利贴 (0.90s)    |
| 侧滑 (0.60s)       | 横向模糊 (0.50s)      | 闪现 (0.44s)      | 水墨 (2.43s)     |
| 交叉震动 (0.83s)     | 抖动横移 (0.57s)      | 抖动变焦 (0.80s)    | 斜向拉丝 (0.67s)   |
| 拉丝滑入 (0.50s)     | 果冻\_I (0.80s)     | 果冻\_II (0.80s)  | 烟雾弹 (1.20s)    |
| 震波 (0.80s)       | 震波\_II (0.83s)    | 震波\_III (1.70s) | 旋转圆球 (0.80s)   |
| 转圈圈 (0.80s)      | 曝光放射 (0.80s)      | 玻璃聚集 (1.70s)    | 分屏横移 (1.00s)   |
| 流金 (1.50s)       | 心形放大 (1.50s)      | 老电视 (1.40s)     | 脉冲 (0.90s)     |
| 能量立方 (1.33s)     | 波纹弹动 (1.20s)      |                 |                |

### 出场动画 快查表

您可以在本表中快速查找：出场动画名称 (默认时长)。

<Tip>
  当使用插件中的 `outro_animation` 参数时，填写表中的 `出场动画名称` 即可。
</Tip>

| **出场动画名称**     |                  |                 |              |
| :------------- | :--------------- | :-------------- | :----------- |
| 向上转出 (0.500)   | 向上转出\_II (0.500) | 跳转闭幕 (0.733)    | 镜像翻转 (0.500) |
| 旋转闭幕 (1.000)   | 漩涡旋转 (0.500)     | 向上滑动 (0.500)    | 向下滑动 (0.500) |
| 向左滑动 (0.500)   | 向右滑动 (0.500)     | 折叠闭幕 (1.500)    | 轻微放大 (0.500) |
| Kira游动 (2.267) | 缩小 (0.500)       | 放大 (0.500)      | 旋转 (0.500)   |
| 斜切 (0.700)     |                  |                 |              |
| 渐隐 (0.500)     | 空间扭曲 (0.930)     | 弹远 (1.200)      | 四屏转换 (0.900) |
| 分屏翻转 (0.560)   | 冲撞 (0.767)       | 旋转圆球 (0.800)    | 砸出波纹 (1.366) |
| 交叉震动 (0.466)   | 能量立方 (1.133)     | 横向模糊 (0.500)    | 多层环形 (1.633) |
| 斜向拉丝 (0.500)   | 分屏横移 (0.880)     | \_2024 (1.000)  | 扫描 (0.633)   |
| 曝光放射 (0.500)   | 色散波纹 (0.767)     | 马赛克 (1.000)     | 十字震动 (0.533) |
| 震动波纹 (1.500)   | 弹力分割 (1.060)     | 震波\_III (0.733) | 立体翻转 (1.100) |
| 流金 (1.133)     | 划水 (0.800)       | 发光矩形 (1.133)    | 玻璃爆开 (0.733) |
| 转圈圈 (0.800)    | 烟雾弹 (0.900)      | 闪现 (0.250)      | 圆形闭幕 (0.900) |
| 飘散 (2.000)     | 闪屏 (0.833)       | 老电视 (1.600)     | 向上闪出 (0.700) |
| 交错闭幕 (1.100)   | 心形缩小 (1.000)     | 水墨 (2.033)      | 折叠 (0.300)   |
| 画出爱心 (1.100)   | 侧滑 (0.400)       | 抖动横移 (0.400)    | 便利贴 (0.800)  |
| 拼图 (1.100)     | 向下甩动 (1.000)     | 脉冲 (0.800)      | 向上滚动 (1.000) |
| 拉丝滑出 (0.500)   | 波纹弹动 (1.200)     | 快速翻页 (0.200)    | 荧光爆闪 (0.800) |
| 模糊聚焦 (0.833)   | 抖动变焦 (0.500)     | 爱心碰撞 (2.300)    |              |

### 关键帧属性 快查表

您可以在本表中快速查找：关键帧属性名称。

<Tip>
  当使用插件中的 `kf_property` 或 `kf_propertys` 参数时，填写表中的 `关键帧属性名称` 即可。
</Tip>

| **关键帧属性名称**    | **作用描述**                |
| :------------- | :---------------------- |
| position\_x    | 在X轴上水平移动，右移为正数，左移为负数    |
| position\_y    | 在Y轴上垂直移动，上移为正数，下移为负数    |
| rotation       | 顺时针旋转的角度                |
| uniform\_scale | 素材的缩放比例，1 为不缩放          |
| alpha          | 透明度，1 为完全不透明            |
| saturation     | 饱和度，0 为原始饱和度，范围为 -1 到 1 |
| contrast       | 对比度，0 为原始对比度，范围为 -1 到 1 |
| brightness     | 亮度，0 为原始亮度，范围为 -1 到 1   |
| volume         | 音量，1 为原始音量，仅对视频和音频素材有效  |

### 特效 快查表

您可以在本表中快速查找：特效名称。

<Tip>
  当使用插件中的 `effect_name` 参数时，填写表中的 `特效名称` 即可。
</Tip>

| **特效名称**    |              |              |             |
| :---------- | :----------- | :----------- | :---------- |
| \_1998      | \_70s        | \_90s画质      | DV录制框       |
| DV界面        | I\_Lose\_You | I\_Love\_You | JVC         |
| List边框      | MV封面         | New\_Year    | PS边框        |
| RGB描边       | VCR          | X\_Signal    | X开幕         |
| betamax     | emoji钻石      | ins界面        | ins风放大镜     |
| kirakira    | ktv灯光        | ktv灯光\_II    | windows弹窗关闭 |
| windows弹窗打开 | 丁达尔光线        | 万圣emoji      | 万圣夜         |
| 三屏          | 三格漫画         | 下雨           | 不对劲         |
| 不规则黑框       | 两屏           | 中枪了          | 乌鸦飞过        |
| 九屏          | 九屏跑马灯        | 亮片           | 人鱼滤镜        |
| 仙女变身        | 仙女变身\_II     | 仙女棒          | 仙尘闪闪        |
| 低像素         | 低像素\_II      | 倒计时\_II      | 像素画         |
| 像素纹理        | 光斑虚化         | 光斑飘落         | 光晕          |
| 光晕\_II      | 全剧终          | 六屏           | 关月亮         |
| 冰冷实验室       | 冰霜           | 冰霜\_II       | 冲击波         |
| 冲刺          | 冲刺\_II       | 冲刺\_III      | 冲屏闪粉        |
| 凄凉          | 几何图形         | 刀光剑影         | 分屏开幕        |
| 初雪\_I       | 加载甜蜜         | 动感模糊         | 动感荧光        |
| 动感蓝带        | 单色涂鸦         | 南瓜光斑         | 南瓜笑脸        |
| 卷动          | 原相机          | 友友商店         | 反转片\_I      |
| 发光          | 取景框          | 取景框\_II      | 变形了         |
| 变彩色         | 变清晰          | 变清晰\_II      | 变焦推镜        |
| 变秋天         | 变黑白          | 告白氛围         | 咔嚓          |
| 哈哈弹幕        | 哈苏胶片         | 唱片           | 唱片封面        |
| 啊啊啊啊        | 噪点           | 四屏           | 回弹摇摆        |
| 回忆文件夹       | 回忆胶片         | 圆形虚线放大镜      | 圣诞光斑        |
| 圣诞星光        | 地狱使者         | 基础黑框         | 塑料封面        |
| 塑料封面\_II    | 塑料封面III      | 复古DV         | 复古DV\_II    |
| 复古DV\_III   | 复古DV\_IV     | 复古发光         | 复古多格        |
| 复古弹窗\_I     | 复古弹窗\_II     | 复古漫画         | 复古甜心        |
| 复古碎钻        | 复古蓝调         | 夏日冰块         | 夏日泡泡\_I     |
| 夕阳          | 夕阳\_II       | 夕阳\_III      | 夜蝶          |
| 夜视框         | 大雪           | 大雪纷飞         | 天使光         |
| 天使降临        | 失焦           | 夸夸弹幕         | 夺冠          |
| 孔明灯         | 孔明灯\_II      | 字幕投影         | 字幕投影\_II    |
| 字幕投影\_III   | 字幕投影\_IV     | 定格闪烁         | 小剧场         |
| 小动物         | 小花花          | 少女心          | 少女心事        |
| 少女星闪        | 左右摇晃         | 布拉格          | 幻彩文字        |
| 幻影          | 幻影\_II       | 幻术摇摆         | 幻觉          |
| 广角          | 庆祝彩带         | 开幕           | 开幕\_\_II    |
| 强锐化         | 录像带          | 录像带\_II      | 录像带\_III    |
| 录制框         | 录制边框         | 录制边框\_II     | 录制边框\_III   |
| 录制边框\_IIII  | 彩信           | 彩噪画质         | 彩带          |
| 彩色描边        | 彩色漫画         | 彩色负片         | 彩虹光         |
| 彩虹光\_II     | 彩虹光晕         | 彩虹射线         | 彩虹幻影        |
| 彩虹气泡        | 彩虹爱心         | 彩钻           | 心河          |
| 心跳          | 心跳黑框         | 必杀技          | 必杀技\_II     |
| 怀旧边框        | 怀旧边框\_II     | 怦然心动         | 恐怖故事        |
| 恐怖故事\_II    | 恐怖故事\_III    | 恐怖综艺         | 恶灵冲屏        |
| 愛           | 我酸了          | 手帐边框         | 手电筒         |
| 手绘拍摄器       | 手绘边框\_II     | 扫描光条         | 抖动          |
| 折痕          | 折痕\_II       | 折痕\_III      | 折痕\_IV      |
| 折痕\_V       | 报纸\_今日热门     | 摇摆           | 摇摆\_II      |
| 撒星星         | 撒星星\_II      | 撕纸涂鸦边框       | 播放器         |
| 播放器\_II     | 擦拭开幕         | 放大镜          | 放映机         |
| 放映机卡顿       | 放映机抖动        | 放映滚动         | 故障          |
| 故障\_II      | 故障读条         | 文字闪动         | 斑斓          |
| 斜向模糊        | 方形取景器        | 方形开幕         | 旋转方块        |
| 日式DV        | 日文字幕         | 日落灯          | 时光碎片        |
| 时间停止        | 星光           | 星光\_II       | 星光绽放        |
| 星光闪耀        | 星光闪闪         | 星夜           | 星星冲屏        |
| 星星坠落        | 星星投影         | 星星灯          | 星星闪烁        |
| 星星闪烁\_II    | 星星闪烁\_III    | 星月童话         | 星河          |
| 星河\_II      | 星火           | 星火\_II       | 星火炸开        |
| 星移          | 星空           | 星辰           | 星辰\_I       |
| 星辰\_II      | 星辰\_III      | 星雨           | 春日樱花        |
| 春日边框        | 晴天光线         | 暗夜           | 暗夜归来        |
| 暗夜彩虹        | 暗夜彩虹\_II     | 暗夜彩虹III      | 暗夜精灵        |
| 暗夜蝙蝠        | 暗角           | 暗黑剪影         | 暗黑噪点        |
| 暗黑蝙蝠        | 曝光           | 曝光降低         | 月亮投影        |
| 月亮闪闪        | 月光闪闪         | 望远镜          | 未来主义        |
| 杂志          | 树影           | 树影\_II       | 格纹纸质        |
| 格纹纸质\_II    | 梦境           | 梦境\_II       | 梦境\_III     |
| 梦境\_IV      | 梦幻雪花         | 梦蝶           | 梦魇          |
| 梵高背景        | 模糊           | 模糊开幕         | 模糊星光        |
| 模糊星光\_II    | 模糊闭幕         | 横向闭幕         | 横纹故障        |
| 横纹故障\_II    | 樱花朵朵         | 橘色负片         | 欧根纱         |
| 毛刺          | 毛玻璃          | 水墨晕染         | 水彩晕染        |
| 水波纹         | 水波纹投影        | 水滴模糊         | 水滴滚动        |
| 油画纹理        | 泡泡           | 泡泡变焦         | 波纹扭曲        |
| 波纹色差        | 流动烟雾         | 流星雨          | 浓雾          |
| 浪漫氛围        | 浪漫氛围\_II     | 涂鸦切割边框       | 淡彩边框        |
| 清新绿格子       | 渐显开幕         | 渐渐放大         | 渐隐闭幕        |
| 温柔细闪        | 游戏界面         | 满屏问号         | 漏光噪点        |
| 火光          | 火光刷过         | 火光包围         | 火光翻滚        |
| 火光蔓延        | 灵魂出窍         | 炫彩           | 炫彩\_II      |
| 烟花          | 烟花\_II       | 烟花\_III      | 烟雾          |
| 烟雾炸开        | 爆炸           | 爱心Kira       | 爱心bling     |
| 爱心光斑        | 爱心光斑\_II     | 爱心光波         | 爱心啵啵        |
| 爱心射线        | 爱心投影         | 爱心方块         | 爱心暗角        |
| 爱心气泡        | 爱心泡泡         | 爱心爆炸         | 爱心缤纷        |
| 爱心缤纷\_II    | 爱心跳动         | 爱心跳动\_II     | 爱心闪烁        |
| 牛皮纸关闭       | 牛皮纸打开        | 牛皮纸边框\_I     | 牛皮纸边框\_II   |
| 玫瑰花瓣        | 玻璃破碎         | 甜心投影         | 生日快乐        |
| 电光包围        | 电光漩涡         | 电子屏          | 电影刮花        |
| 电影感         | 电影感画幅        | 电脑桌面         | 电视关机        |
| 电视开机        | 电视彩虹屏        | 电视纹理         | 画展边框        |
| 白噪点边框       | 白胶边框         | 白色描边         | 白色渐显        |
| 白色爱心        | 白色线框         | 白色边框         | 百叶窗         |
| 百叶窗\_II     | 监控           | 盗梦空间         | 盛世美颜        |
| 相机网格        | 相纸           | 瞬间模糊         | 破冰          |
| 磨砂纹理        | 祝福环绕         | 秋日暖黄         | 空灵          |
| 窗格          | 窗格光          | 简约边框         | 箭头放大镜       |
| 粉红老电视       | 粉红芭比边框       | 粉色闪粉         | 粉黄渐变        |
| 粒子模糊        | 精灵闪粉         | 精细锐化         | 糖果纸         |
| 紫色波纹        | 紫色负片         | 紫雾           | 繁星点点        |
| 纵向开幕        | 纵向模糊         | 纸膜边框\_I      | 纸膜边框\_II    |
| 纸质撕边        | 纸质边框         | 纸质边框\_II     | 细闪          |
| 细闪\_II      | 细闪\_III      | 美式           | 美式\_II      |
| 美式\_III     | 美式\_IV       | 美式\_V        | 美漫          |
| 羽毛          | 老照片          | 老照片\_II      | 老照片\_III    |
| 老电影         | 老电影\_II      | 老电视卡顿        | 聚光灯         |
| 聚焦          | 胡言乱语         | 胶片           | 胶片\_II      |
| 胶片\_III     | 胶片\_IV       | 胶片抖动         | 胶片显影        |
| 胶片框         | 胶片框\_II      | 胶片框\_III     | 胶片漏光        |
| 胶片漏光\_II    | 胶片连拍         | 自然           | 自然\_II      |
| 自然\_III     | 自然\_IV       | 自然\_V        | 色差          |
| 色差开幕        | 色差放大         | 色差放射         | 色差故障        |
| 色差故障\_II    | 色差星闪         | 色差默片         | 节日彩带        |
| 花火          | 花火\_II       | 花瓣飘落         | 花瓣飞扬        |
| 荡漾\_II      | 荡秋千          | 荧光扫描         | 荧光爱心        |
| 荧光线描        | 荧光绿          | 荧光蝙蝠         | 荧幕噪点        |
| 荧幕噪点\_II    | 萤光           | 萤光飞舞         | 萤火          |
| 落叶          | 落樱           | 蒸汽波          | 蒸汽波投影       |
| 蒸汽波路灯       | 蒸汽腾腾         | 蓝光扫描         | 蓝线模糊        |
| 蓝色负片        | 蓝色闪电边框       | 虚化           | 蝙蝠Kira      |
| 蝴蝶          | 蝴蝶\_II       | 蝴蝶光斑         | 蝶舞          |
| 表面模糊        | 裂开了          | 视频分割         | 视频界面        |
| 诡异分割        | 负片闪烁         | 赞赞赞          | 蹦迪光         |
| 蹦迪彩光        | 车窗           | 车窗影          | 轻微抖动        |
| 轻微放大        | 边缘glitch     | 边缘加色         | 边缘加色\_II    |
| 边缘加色\_III   | 边缘发光         | 边缘荧光         | 运动一夏        |
| 迪斯科         | 迷幻烟雾         | 迷离           | 迷雾          |
| 逆光对焦        | 选中框          | 邮票边框         | 金属背景        |
| 金片          | 金片\_II       | 金片炸开         | 金粉          |
| 金粉\_II      | 金粉\_III      | 金粉撒落         | 金粉旋转        |
| 金粉聚拢        | 金粉闪闪         | 钻光           | 钻石碎片        |
| 镜像          | 镜头变焦         | 长虹玻璃         | 闪亮登场        |
| 闪亮登场\_II    | 闪光震动         | 闪动           | 闪动光斑        |
| 闪屏          | 闪电           | 闪白           | 闪耀星光        |
| 闪闪          | 闪闪发光\_II     | 闪黑           | 闪黑II        |
| 闭幕          | 闭幕\_II       | 随机色块         | 随机色块\_II    |
| 随机裁剪        | 隐形人          | 隔行扫描         | 雨滴晕开        |
| 雪窗          | 雪花           | 雪花冲屏         | 雪花开幕        |
| 雪花故障        | 雪花细闪         | 零点解锁         | 雾气          |
| 雾气\_II      | 雾气光线         | 震动           | 霓虹投影        |
| 霓虹摇摆        | 霓虹灯          | 预警           | 颤抖          |
| 飘落花瓣        | 飘落闪粉         | 飘落闪粉\_II     | 飘雪          |
| 飘雪\_II      | 飞速计算         | 马赛克          | 高光瞬间        |
| 魅力光束        | 魔法           | 魔法变身         | 魔法边框        |
| 魔法边框\_II    | 鱼眼           | 黄蓝星芒         | 黑白VHS       |
| 黑白三格        | 黑白漫画         | 黑白漫画\_II     | 黑白线描        |
| 黑线故障        | 黑羽毛          | 黑羽毛\_II      | 黑胶边框        |
| 黑色噪点        | 黑色老电视        | Bling飘落      | C300        |
| IXUS        | Ins描边        | S形运镜         | W830        |
| 一刀两断        | 丁达尔旋焦        | 丝印涂鸦         | 丝滑运镜        |
| 两屏分割        | 中轴旋转         | 云朵绵绵         | 五星好评        |
| 交叉震闪        | 低保真          | 侧移模糊         | 倒带          |
| 倒计时         | 像素屏闪         | 像素扫描         | 像素拉伸\_II    |
| 像素排序        | 像素故障         | 像素爱心         | 像素震闪        |
| 光线扫描        | 光线拖影         | 光谱扫描         | 兔兔碎闪        |
| 全息扫描        | 分屏漏光         | 动态侦测         | 动态格         |
| 动感光束        | 动感变焦         | 动感扫光         | 动感推镜        |
| 动感竖线        | 动感运镜         | 十字模糊         | 十字爆闪        |
| 单向移动        | 单彩渐变         | 单色填充         | 卡机          |
| 卡通渲染        | 发光HDR        | 取景器          | 变色狙击        |
| 变色闪光        | 变速推镜         | 变速推镜II       | 可爱涂鸦        |
| 吓到失魂        | 噪片映射         | 圆形分屏         | 圣诞日记        |
| 复古彩虹        | 复古拼贴         | 复古紫调         | 复古红调        |
| 复古连拍        | 复古闪闪         | 复古频闪         | 失焦CCD       |
| 失焦光斑        | 定格祝福         | 实况开幕         | 对焦DV        |
| 局部推镜        | 局部色彩         | 居中闪切         | 屏幕律动        |
| 幻动光斑        | 幻彩故障         | 幻影\_I        | 弹动摇镜        |
| 弹动旋入        | 弹性闪动         | 彩光摇晃         | 彩光频闪        |
| 彩色像素        | 彩色流光\_I      | 彩色流光\_II     | 彩色流光\_III   |
| 彩色火焰        | 彩色珠滴         | 彩色电光         | 彩色碎彩        |
| 彩色碎片        | 彩色碎片\_II     | 彩色闪烁         | 彩虹光影        |
| 彩虹棱镜        | 彩虹泛光         | 彩虹闪屏         | 彩边频闪        |
| 微震闪黑        | 心跳\_II       | 快速变焦         | 快闪运镜        |
| 恐怖涂鸦        | 慢门拖影         | 手写边框         | 扭动变焦        |
| 扭曲变焦        | 扭曲模糊         | 抖动模糊         | 抽帧拖影        |
| 拉伸旋镜        | 拉扯震动         | 拉镜开幕         | 拍照定格        |
| 拖影灯光        | 拟截图放大镜       | 推拉跟随         | 推拉运镜        |
| 摇晃叠影        | 摇晃推镜         | 摇晃运镜         | 撕纸特写        |
| 播放界面        | 故障定格         | 故障开幕         | 故障震闪        |
| 散光弹动        | 散光闪烁         | 数字矩阵         | 斜线震动        |
| 新年仙女棒       | 方形模糊         | 旋焦           | 旋焦推镜        |
| 旋转变焦        | 旋转回弹         | 旋转圆球         | 旋转抖动        |
| 旋转抖动\_II    | 星星变焦         | 曝光变焦         | 曝光扩散        |
| 曲线模糊        | 极速旋转         | 柔和辉光         | 梦幻辉光        |
| 模拟拍照        | 横向闪光         | 横条开幕         | 樱花飘落        |
| 欧根纱II       | 气球花花         | 氛围边框         | 水光影         |
| 水波倒影        | 水波模糊         | 水波泛起         | 水波流动        |
| 水滴扩散        | 油画模糊         | 法式暖调         | 法式涂鸦        |
| 泛光扫描        | 泛光爆闪         | 泛光闪动         | 泡泡光斑        |
| 泡泡冲屏        | 波动清晰         | 波浪           | 波浪丝印        |
| 波纹闪动        | 流体冲屏         | 流体荡开         | 海报描边        |
| 海鸥DC        | 液态分离         | 漂浮爱心         | 潮流涂鸦        |
| 瀑布开幕        | 灵魂出窍\_II     | 灿灿金币         | 灿金彩带        |
| 炫光变焦        | 炫光扫描         | 烟花2024       | 热恋          |
| 爆闪锐化        | 爱心扫光         | 爱心气球         | 爱心软糖        |
| 爱心边框        | 珠光Kira       | 珠光碎闪         | 电光描边        |
| 电光波动        | 电光爆闪         | 电光爆闪\_II     | 电光爱心        |
| 电音故障        | 画质清晰         | 白鸽           | 相片定格        |
| 矩阵频闪        | 碎闪描边         | 磁带DV         | 磨砂水晶        |
| 神龙纳福        | 秋日暖阳         | 移轴模糊         | 竖向开幕        |
| 竖向闪光        | 竖线屏闪         | 竖闪模糊         | 粉雪          |
| 粒子放射        | 精致辉光         | 紫光夜          | 繁花棱镜II      |
| 红蓝魔         | 红边模糊         | 纵向跳动         | 纸质抽帧        |
| 线光变速        | 线条涂鸦         | 缤纷           | 网点丝印        |
| 群蝶飞舞        | 羽毛飘落         | 翻转变焦         | 翻转开幕        |
| 老式DV        | 胶片V          | 胶片冷绿         | 胶片暖棕        |
| 胶片滚动        | 胶片闪切         | 脉搏跳动         | 色差震闪        |
| 色散冲击        | 色散故障         | 花屏故障         | 花瓣环绕        |
| 菱形光斑        | 菱形变焦         | 落叶\_II       | 蓝光爆闪        |
| 蓝色丝印        | 虹光旋入         | 视频播放         | 负片分屏        |
| 负片涂鸦        | 负片涂鸦\_II     | 负片涂鸦\_III    | 负片游移        |
| 负片频闪        | 超大光斑         | 超强锐化         | 跟随运镜        |
| 跟随运镜\_II    | 车窗\_II       | 辉光开幕         | 边缘扫光        |
| 迷幻故障        | 迷幻荡漾         | 迷幻震动         | 重复变焦        |
| 重复震闪        | 金色碎片         | 金边闪烁         | 银杏飘落        |
| 闪光弹跳        | 闪光灯\_II      | 闪光灯IV        | 闪电扭曲        |
| 闪白\_II      | 随机闪切         | 随机马赛克        | 隔行DV        |
| 雨季\_I       | 雪花光斑         | 雪雾           | 雾镜\_II      |
| 震动光束        | 震动发光         | 震动屏闪         | 震动扫光        |
| 震动推镜        | 震闪渐黑         | 霓虹光线         | 霓虹闪切        |
| 马赛克闪切       | 高速彩光         | 鱼眼\_II       | 鱼眼\_III     |
| 鱼眼\_IV      | 黑白胶片         |              |             |