JianYingAPI
main
  • main
  • afanti
  1. 关键帧
JianYingAPI
main
  • main
  • afanti
  • 默认模块
    • 一分钟,了解 流光剪辑!
    • 扣子工作流示例
    • 如何下载草稿
    • 在线预览草稿
    • 获取API Key
    • 使用工作流功能
    • 飞书智能表格示例
    • 直播间演示
    • 文本
      • 使用花字
      • 使用文字模版
      • 如何上传文字模板
      • get_text_intro_types
      • get_text_outro_types
      • get_text_loop_anim_types
      • get_font_types
      • add_text
      • add_subtitle
      • search_artist
      • add_text_template
    • 图片
      • get_intro_animation_types
      • get_outro_animation_types
      • get_combo_animation_types
      • add_image
    • 视频
      • add_video
    • 转场
      • get_transition_types
    • 蒙版
      • get_mask_types
    • 音频
      • get_audio_effect_types
      • add_audio
    • 关键帧
      • add_video_keyframe
        POST
    • 特效
      • get_video_character_effect_types
      • get_video_scene_effect_types
      • add_effect
    • 贴纸
      • search_sticker
      • add_sticker
    • 云渲染
      • generate_video
      • task_status
    • 工作流
      • 工作流脚本技术文档
      • 工作流 AI Prompt 提示词
      • execute_workflow
    • 模版/预设
      • 如何使用模版/预设功能
      • 如何上传模版
      • add_preset
    • 滤镜
      • add_filter
      • get_filter_types
    • create_draft
      POST
    • save_draft
      POST
    • get_duration
      POST
  1. 关键帧

add_video_keyframe

POST
/add_video_keyframe
关键帧用来给视频添加缩放/移动/明暗变化/音量变化的效果。
使用这个接口给指定轨道,不仅仅是视频,添加关键帧
支持批量添加。

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Body 参数application/json

示例

返回响应

🟢200成功
application/json
Body

请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.capcutapi.top/cut_jianying/add_video_keyframe' \
--header 'Authorization: Bearer  <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "draft_id": "dfd_cat_1753709045_3a033ea7",  // 草稿ID(必填,指定要操作的草稿)
    "track_name": "video_main",  // 轨道名称(选填,默认"video_main",指定要添加关键帧的轨道)
    
    // 单个关键帧参数(向后兼容,用于添加单个关键帧)
    "property_type": "alpha",  // 属性类型(选填,默认"alpha"不透明度,可选值如"scale_x"、"rotation"等)
    "time": 0.0,  // 关键帧时间(秒,选填,默认0.0秒)
    "value": "1.0",  // 属性值(选填,默认"1.0",需根据property_type调整类型,如数字、字符串等)
    
    // 批量关键帧参数(新增,优先使用,用于一次性添加多个关键帧)
    "property_types": ["alpha", "scale_x"],  // 属性类型列表(选填,数组形式,与times、values对应)
    "times": [0.0, 2.0],  // 时间列表(选填,数组形式,与property_types、values对应)
    "values": ["1.0", "0.8"]  // 值列表(选填,数组形式,与property_types、times对应)
}'
响应示例响应示例
{
    "error": "",
    "output": {
        "added_keyframes_count": 2,
        "draft_id": "dfd_cat_1752374660_d5424447",
        "draft_url": "https://www.install-ai-guider.top/draft/downloader?draft_id=dfd_cat_1752374660_d5424447"
    },
    "purchase_link": "https://www.coze.cn/store/project/7498257920212647946?entity_id=1&bid=6g6miqtbk3009",
    "success": true
}
修改于 2025-12-03 01:55:57
上一页
add_audio
下一页
get_video_character_effect_types
Built with