
详细每个节点使用说明:
![图片[1]-add_video_keyframe 添加视频关键帧 – 剪映助手-爱智特agent,一站式企业智能体推荐平台,扣子企业智能体,扣子工作流免费复制下载](https://img.aiggc.com/wp-content/uploads/2025/07/20250722115415479.png?x-oss-process=style/aiznt)
为指定视频轨道添加关键帧,支持配置关键帧的时间、属性类型(如透明度、位置等)及对应值。
请求参数
参数名 | 类型 | 是否必填 | 默认值 | 说明 |
draft_id | String | 是 | – | 草稿ID(需指定目标草稿) |
track_name | String | 否 | "main" | 轨道名称(默认主轨道,需与目标视频所在轨道一致) |
property_type | String | 否 | "alpha" | 单关键帧模式下的属性类型,支持:add_video_keyframe |
time | Number | 否 | 0.0 | 单关键帧模式下的时间点(秒) |
value | String | 否 | "1.0 “ | 单关键帧模式下的属性值(格式取决于 property_type ,如透明度为 "0.5" ) |
property_types | Array | 否 | – | 批量模式下的属性类型列表(与 times 、values 一一对应) |
times | Array | 否 | – | 批量模式下的时间点列表(秒) |
values | Array | 否 | – | 批量模式下的属性值列表 |
返回结果
字段 | 类型 | 说明 |
success | boolean | 请求是否成功 |
output | object | 处理结果结构体,包含:draft_id :字符串类型,生成的草稿ID |
error | string | 错误信息(失败时返回,包含帮助链接) |
purchase_link | string | 购买链接(用于错误提示) |
使用说明:
- 单关键帧模式:
- 同时提供
property_type
、time
、value
参数。 - 示例:添加一个0.5秒时透明度为0.8的关键帧。
- 同时提供
- 批量模式:
- 同时提供
property_types
、times
、values
三个数组参数,忽略单关键帧参数。 - 三个数组必须长度一致,按索引位置一一对应。
- 示例:
- 同时提供
- 关键帧属性
property_type
,支持以下值:- position_x: 水平位置,0表示居中,1表示向右移动一个屏幕宽度
- position_y: 垂直位置,0表示居中,1表示向下移动一个屏幕高度
- rotation: 顺时针旋转角度
- scale_x: X轴缩放比例(1.0为不缩放),与uniform_scale互斥
- scale_y: Y轴缩放比例(1.0为不缩放),与uniform_scale互斥
- uniform_scale: 整体缩放比例(1.0为不缩放),与scale_x和scale_y互斥
- alpha: 不透明度,1.0为完全不透明
- saturation: 饱和度,0.0为原始饱和度,范围为-1.0到1.0
- contrast: 对比度,0.0为原始对比度,范围为-1.0到1.0
- brightness: 亮度,0.0为原始亮度,范围为-1.0到1.0
- volume: 音量,1.0为原始音量
- value: 关键帧值,格式根据property_type不同而不同:
- position_x/position_y: “0”表示居中位置
- rotation: “45”表示45度
- scale_x/scale_y/uniform_scale: “1.5”表示放大1.5倍
- alpha: “0.5”表示50%不透明度
- saturation/contrast/brightness: “+0.5/0.5″表示增加0.5,”-0.5″表示减少0.5
- volume: “0.8”表示原始音量的80%
- 向后兼容性:
- 旧版只传单关键帧参数的请求仍然兼容,但建议优先使用批量模式。
© 版权声明
AI智能体所有文章,如无特殊说明或标注,均为本站作者原创发布。任何个人或组织,在未征得作者同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若此作者内容侵犯了原著者的合法权益,可联系客服处理。
THE END
暂无评论内容