剪映API服务
  1. 关键帧
剪映API服务
  • 一分钟,了解 剪映API服务!
  • 用户
    • 用户注册
      POST
    • 用户登录
      POST
  • 草稿
    • 创建草稿
      POST
    • 保存草稿
      POST
  • 文本
    • 获取文本入场动画
      GET
    • 获取文本出场动画
      GET
    • 获取文本循环动画
      GET
    • 获取字体
      GET
    • 获取花字
      GET
    • 添加文字(支持花字)
      POST
    • 添加字幕(支持花字)
      POST
    • 添加文字模板
      POST
  • 图片
    • 获取图片入场动画
      GET
    • 获取图片出场动画
      GET
    • 获取图片组合动画
      GET
    • 添加图片
      POST
  • 视频
    • 添加视频
      POST
  • 转场
    • 获取转场动画
      GET
  • 蒙版
    • 获取蒙版
      GET
  • 音频
    • 获取音频特效
      GET
    • 添加音频
      POST
  • 关键帧
    • 添加关键帧
      POST
  • 特效
    • 获取人物特效列表
    • 获取场景特效列表
    • 添加特效
  • 贴纸
    • 添加贴纸
  • 云渲染
    • 创建任务
    • 获取任务状态
    • 获取任务列表
  • 语音合成
    • 获取音色列表
    • 生成语音
  • 通用
    • 获取音视频时长
  1. 关键帧

添加关键帧

POST
/keyframe/add_keyframe
向指定轨道添加关键帧,支持批量操作

请求参数

Authorization
API Key
在 header 添加参数
x-api-key
示例:
x-api-key: ********************
or
Body 参数application/json

示例

返回响应

🟢200成功
application/json
Body

🟢200失败
🟢200参数不正确
🔴500服务器异常
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://capcut.yyzc.net.cn/keyframe/add_keyframe' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "draft_id": "111", // 草稿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对应)
}'
响应示例响应示例
200 - 成功示例
{
    "code": 200,
    "message": "请求成功",
    "data": {
        "draft_id": "yyzc_capcut_1757382649_e406991f",
        "draft_url": "https://capcut.yyzc.net.cn/draft/downloader?draft_id=yyzc_capcut_1757382649_e406991f&is_capcut=0"
    },
    "timestamp": 1757382649149
}
修改于 2025-09-09 02:56:40
上一页
添加音频
下一页
获取人物特效列表
Built with