JianYingAPI
  1. 视频
JianYingAPI
  • 一分钟,了解 剪映API!
  • 如何下载草稿
  • 在线预览草稿
  • 获取API Key
  • 文本
    • get_text_intro_types
      GET
    • get_text_outro_types
      GET
    • get_text_loop_anim_types
      GET
    • get_font_types
      GET
    • add_text
      POST
    • add_subtitle
      POST
  • 图片
    • get_intro_animation_types
      GET
    • get_outro_animation_types
      GET
    • get_combo_animation_types
      GET
    • add_image
      POST
  • 视频
    • add_video
      POST
  • 转场
    • get_transition_types
      GET
  • 蒙版
    • get_mask_types
      GET
  • 音频
    • get_audio_effect_types
      GET
    • add_audio
      POST
  • 关键帧
    • add_video_keyframe
      POST
  • 特效
    • get_video_character_effect_types
      GET
    • get_video_scene_effect_types
      GET
    • add_effect
      POST
  • 贴纸
    • search_sticker
    • add_sticker
  • 云渲染
    • generate_video
    • task_status
  • create_draft
    POST
  • save_draft
    POST
  • get_duration
    POST
  1. 视频

add_video

POST
/add_video
添加视频
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://open.capcutapi.top/cut_jianying/add_video' \
--header 'Authorization: Bearer your-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": 0,  // 视频素材的结束截取时间(秒,选填,默认0,0通常表示截取至视频末尾)
    "width": 1080,  // 画布宽度(选填,默认1080)
    "height": 1920,  // 画布高度(选填,默认1920)
    "draft_id": "draft_123456",  // 草稿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": 0,  // 视频在时间线上的起始位置(秒,选填,默认0)
    "track_name": "video_main",  // 轨道名称(选填,默认"video_main")
    "relative_index": 0,  // 相对索引(选填,默认0,用于控制轨道内素材的排列顺序)
    "duration": null,  // 视频素材的总时长(秒,选填,主动设置可以提升当前节点运行速度)
    "transition": "云朵",  // 转场类型(选填,如"云朵"等,需与支持的类型匹配)
    "transition_duration": 0.5,  // 转场持续时间(秒,选填,默认0.5)
    "volume": 1.0,  // 视频音量(选填,默认1.0,范围通常为0.0-1.0)
    // 蒙版相关参数
    "mask_type": "圆形",  // 蒙版类型(选填,如圆形、矩形等)
    "mask_center_x": 0.5,  // 蒙版中心X坐标(选填,默认0.5,相对屏幕宽度比例)
    "mask_center_y": 0.5,  // 蒙版中心Y坐标(选填,默认0.5,相对屏幕高度比例)
    "mask_size": 1.0,  // 蒙版大小(选填,默认1.0,相对屏幕高度比例)
    "mask_rotation": 0.0,  // 蒙版旋转角度(选填,默认0.0度)
    "mask_feather": 0.0,  // 蒙版羽化程度(选填,默认0.0,值越大边缘越柔和)
    "mask_invert": false,  // 是否反转蒙版(选填,默认false)
    "mask_rect_width": null,  // 矩形蒙版宽度(选填,仅mask_type为矩形时有效)
    "mask_round_corner": null  // 矩形蒙版圆角(选填,仅mask_type为矩形时有效)
}'
响应示例响应示例
{
    "error": "",
    "output": {
        "draft_id": "dfd_cat_1752374046_d23ea53a",
        "draft_url": "https://www.install-ai-guider.top/draft/downloader?draft_id=dfd_cat_1752374046_d23ea53a"
    },
    "purchase_link": "https://www.coze.cn/store/project/7498257920212647946?entity_id=1&bid=6g6miqtbk3009",
    "success": true
}

请求参数

Header 参数

Body 参数application/json

示例

返回响应

🟢200成功
application/json
Body

修改于 2025-08-08 01:12:17
上一页
add_image
下一页
get_transition_types
Built with