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
        POST
    • 转场
      • get_transition_types
    • 蒙版
      • get_mask_types
    • 音频
      • get_audio_effect_types
      • add_audio
    • 关键帧
      • add_video_keyframe
    • 特效
      • 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

POST
/add_video
添加视频

请求参数

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' \
--header 'Authorization: Bearer  <token>' \
--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
}
修改于 2025-12-03 07:08:40
上一页
add_image
下一页
get_transition_types
Built with