小由和小迪
加入会员

功能简介 ​

为视频添加关键帧动画，实现视频属性的动态变化效果。关键帧可以控制视频的缩放、透明度、位置等属性在不同时间点的值，实现平滑的动画过渡。

使用场景 ​

  • 需要实现视频的缩放动画效果
  • 需要实现视频的淡入淡出效果
  • 需要实现视频的位置移动动画
  • 需要实现视频属性的平滑过渡效果

参数说明 ​

输入参数 ​

参数名类型必填说明
草稿ID字符串是目标草稿的ID
目标轨道名称字符串否要添加关键帧的目标轨道名称，默认video_main，与添加视频的默认轨道名称一致
属性类型列表列表否要设置的关键帧属性类型列表，例如["scale_x", "alpha"]表示设置水平缩放和透明度
时间列表列表否与属性类型列表对应的时间点列表，单位：秒。每个时间点对应一个关键帧
值列表列表否与属性类型列表、时间列表对应的属性值列表。每个值对应一个关键帧的属性值

属性类型说明：

关键帧支持以下17种属性类型，按功能分类如下：

位置相关（4种）：

  • position_x：水平位置（相对值），范围 [-100, 100]，"0" 表示居中位置
  • position_y：垂直位置（相对值），范围 [-100, 100]，"0" 表示居中位置
  • position_x_px：水平位置（像素值），"0" 表示居中位置
  • position_y_px：垂直位置（像素值），"0" 表示居中位置

蒙版相关（6种）：

  • mask_position_x：蒙版水平位置（相对值）
  • mask_positioin_y：蒙版垂直位置（相对值）（注意：API文档中拼写为 mask_positioin_y）
  • mask_position_x_px：蒙版水平位置（像素值）
  • mask_positioin_y_px：蒙版垂直位置（像素值）（注意：API文档中拼写为 mask_positioin_y_px）
  • mask_size_x：蒙版水平大小（像素值）
  • mask_size_y：蒙版垂直大小（像素值）

变换相关（4种）：

  • rotation：旋转角度，例如 "45deg" 表示45度
  • scale_x：水平缩放，1.0为不缩放，例如 "1.5" 表示放大1.5倍（与 uniform_scale 互斥）
  • scale_y：垂直缩放，1.0为不缩放，例如 "1.5" 表示放大1.5倍（与 uniform_scale 互斥）
  • uniform_scale：统一缩放（同时控制X轴和Y轴），1.0为不缩放，例如 "1.5" 表示放大1.5倍（与 scale_x 和 scale_y 互斥）

视觉效果相关（4种）：

  • alpha：透明度，1.0为完全不透明，例如 "50%" 表示50%不透明度，范围 [0.0, 1.0]
  • saturation：饱和度，0.0为原始饱和度，范围 [-1.0, 1.0]，例如 "+0.5" 表示增加0.5，"-0.5" 表示减少0.5
  • contrast：对比度，0.0为原始对比度，范围 [-1.0, 1.0]，例如 "+0.5" 表示增加0.5
  • brightness：亮度，0.0为原始亮度，范围 [-1.0, 1.0]，例如 "+0.5" 表示增加0.5

音频相关（1种）：

  • volume：音量，1.0为原始音量，例如 "80%" 表示原始音量的80%

输出参数 ​

参数名类型必填说明
返回草稿ID字符串是操作后的草稿ID
草稿URL字符串是草稿的访问链接

注意事项 ​

列表对应关系：属性类型列表、时间列表、值列表必须一一对应，长度必须相同

时间顺序：时间列表中的时间点应该按从小到大的顺序排列

属性值格式：不同属性类型的值格式不同：

  • position_x/position_y：数字字符串，范围 [-100, 100]，"0" 表示居中
  • position_x_px/position_y_px：数字字符串（像素值），"0" 表示居中
  • rotation：角度值，例如 "45deg" 表示45度，或直接数字
  • scale_x/scale_y/uniform_scale：缩放比例，例如 "1.5" 表示放大1.5倍
  • alpha：透明度值，例如 "50%" 表示50%不透明度，或直接数字（0.0-1.0）
  • saturation/contrast/brightness：调整值，例如 "+0.5" 表示增加0.5，"-0.5" 表示减少0.5，或直接数字
  • volume：音量值，例如 "80%" 表示原始音量的80%，或直接数字

缩放属性互斥：scale_x/scale_y 与 uniform_scale 不能同时使用，选择其中一种方式设置缩放

属性值范围：不同属性有不同的取值范围，请参考上述属性类型说明中的范围限制

草稿ID：必须提供有效的草稿ID，且草稿中必须存在对应的视频轨道