add_video_keyframe 添加视频关键帧 – 剪映助手

爱智特-AI智能体一站式企业智能体交易学习发行平台|智能体教程|智能体社区

详细每个节点使用说明:

图片[1]-add_video_keyframe 添加视频关键帧 – 剪映助手-爱智特agent,一站式企业智能体推荐平台,扣子企业智能体,扣子工作流免费复制下载

为指定视频轨道添加关键帧,支持配置关键帧的时间、属性类型(如透明度、位置等)及对应值。

请求参数

参数名类型是否必填默认值说明
draft_idString草稿ID(需指定目标草稿)
track_nameString"main"轨道名称(默认主轨道,需与目标视频所在轨道一致)
property_typeString"alpha"单关键帧模式下的属性类型,支持:add_video_keyframe
timeNumber0.0单关键帧模式下的时间点(秒)
valueString"1.0单关键帧模式下的属性值(格式取决于 property_type,如透明度为 "0.5"
property_typesArray批量模式下的属性类型列表(与 timesvalues 一一对应)
timesArray批量模式下的时间点列表(秒)
valuesArray批量模式下的属性值列表

返回结果

字段类型说明
successboolean请求是否成功
outputobject处理结果结构体,包含:draft_id:字符串类型,生成的草稿ID
errorstring错误信息(失败时返回,包含帮助链接)
purchase_linkstring购买链接(用于错误提示)

使用说明:

  1. 单关键帧模式
    1. 同时提供 property_typetimevalue 参数。
    2. 示例:添加一个0.5秒时透明度为0.8的关键帧。
  2. 批量模式
    1. 同时提供 property_typestimesvalues 三个数组参数,忽略单关键帧参数。
    2. 三个数组必须长度一致,按索引位置一一对应。
    3. 示例:
  3. 关键帧属性property_type,支持以下值:
    1. position_x: 水平位置,0表示居中,1表示向右移动一个屏幕宽度
    2. position_y: 垂直位置,0表示居中,1表示向下移动一个屏幕高度
    3. rotation: 顺时针旋转角度
    4. scale_x: X轴缩放比例(1.0为不缩放),与uniform_scale互斥
    5. scale_y: Y轴缩放比例(1.0为不缩放),与uniform_scale互斥
    6. uniform_scale: 整体缩放比例(1.0为不缩放),与scale_x和scale_y互斥
    7. alpha: 不透明度,1.0为完全不透明
    8. saturation: 饱和度,0.0为原始饱和度,范围为-1.0到1.0
    9. contrast: 对比度,0.0为原始对比度,范围为-1.0到1.0
    10. brightness: 亮度,0.0为原始亮度,范围为-1.0到1.0
    11. volume: 音量,1.0为原始音量
  4. value: 关键帧值,格式根据property_type不同而不同:
    1. position_x/position_y: “0”表示居中位置
    2. rotation: “45”表示45度
    3. scale_x/scale_y/uniform_scale: “1.5”表示放大1.5倍
    4. alpha: “0.5”表示50%不透明度
    5. saturation/contrast/brightness: “+0.5/0.5″表示增加0.5,”-0.5″表示减少0.5
    6. volume: “0.8”表示原始音量的80%
  5. 向后兼容性
    1. 旧版只传单关键帧参数的请求仍然兼容,但建议优先使用批量模式。
© 版权声明
THE END
喜欢就支持一下吧
点赞8 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容