add_video_keyframe

POST /add_video_keyframe

接口说明

给视频片段添加画面属性关键帧，支持位置、旋转、缩放、透明度、饱和度、对比度、亮度和音量。单关键帧和批量数组两种写法都支持，所有时间点统一使用秒。

请求参数

参数	必填	默认值	说明
draft_id	是	—	草稿 ID，创建草稿后获得
track_name	否	'video_main'	目标轨道名称
property_type	否	'alpha'	单个关键帧属性类型
time	否	0.0	关键帧时间点，单位秒
value	否	'1.0'	关键帧数值
property_types	是	—	关键帧属性类型数组
times	是	—	关键帧时间点数组，单位秒
values	是	—	关键帧数值数组

调用示例

curl -X POST https://your-domain.example/api/add_video_keyframe \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $VECTCUT_API_KEY" \
  -d '{
    "draft_id": "dfd_cat_demo_001",
    "track_name": "video_main",
    "property_types": ["alpha", "scale_x", "rotation"],
    "times": [0.0, 1.0, 2.0],
    "values": ["100%", "1.2", "45deg"]
  }'

返回格式

{
  "success": true,
  "output": {
    "draft_id": "dfd_cat_demo_001",
    "draft_url": "https://your-domain.example/api/draft/downloader?draft_id=dfd_cat_demo_001",
    "added_keyframes_count": 3
  },
  "error": ""
}