剪映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
  • 关键帧
    • 添加关键帧
  • 特效
    • 获取人物特效列表
    • 获取场景特效列表
    • 添加特效
  • 贴纸
    • 添加贴纸
  • 云渲染
    • 创建任务
    • 获取任务状态
    • 获取任务列表
  • 语音合成
    • 获取音色列表
    • 生成语音
  • 通用
    • 获取音视频时长
  1. 视频

添加视频

POST
/video/add_video
向草稿中添加视频

请求参数

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/video/add_video' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "video_url": "https://cdn.wanx.aliyuncs.com/wanx/1719234057367822001/text_to_video/092faf3c94244973ab752ee1280ba76f.mp4?spm=5176.29623064.0.0.41ed26d6cBOhV3&file=092faf3c94244973ab752ee1280ba76f.mp4", // 视频资源URL(必填,用于获取视频素材)
    "start": 0, // 视频素材的起始截取时间(秒,选填,默认0)
    "end": 5, // 视频素材的结束截取时间(秒,选填,默认0,0通常表示截取至视频末尾)
    "width": 1080, // 画布宽度(选填,默认1080)
    "height": 1920, // 画布高度(选填,默认1920)
    "draft_id": "yyzc_capcut_1757345021_25a8c3cd", // 草稿ID(选填,用于关联目标草稿)
    "transform_y": 0, // Y轴位置偏移(选填,默认0)
    "scale_x": 1, // X轴缩放比例(选填,默认1)
    "scale_y": 1, // Y轴缩放比例(选填,默认1)
    "transform_x": 0, // X轴位置偏移(选填,默认0)
    "speed": 1.0, // 视频播放速度(选填,默认1.0,大于1为加速,小于1为减速)
    "target_start": 2, // 视频在时间线上的起始位置(秒,选填,默认0)
    "track_name": "video_two", // 轨道名称(选填,默认"video_main")
    "relative_index": 0, // 相对索引(选填,默认0,用于控制轨道内素材的排列顺序)
    "duration": null, // 视频素材的总时长(秒,选填,主动设置可以提升当前节点运行速度)
    "transition": "云朵", // 转场类型(选填,如"云朵"等,需与支持的类型匹配)
    "transition_duration": 0.5 // 转场持续时间(秒,选填,默认0.5)
}'
响应示例响应示例
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:36:15
上一页
添加图片
下一页
获取转场动画
Built with