add_image

POST /add_image

接口说明

向草稿添加图片素材，并设置显示区间、位置、缩放、入场动画、出场动画、组合动画和转场。图片的持续时间由 end - start 决定；服务端只保存图片 URL，不下载图片。

请求参数

参数	必填	默认值	说明
`draft_folder`	否	—	草稿输出目录；本地部署时可指定剪映草稿根目录
`image_url`	是	—	远程图片 URL；服务端只保存 URL，不下载图片
`width`	否	`1080`	画布或素材宽度
`height`	否	`1920`	画布或素材高度
`start`	否	`0`	源素材开始时间，单位秒
`end`	否	`3.0`	源素材结束时间，单位秒
`draft_id`	否	—	草稿 ID；省略时创建新草稿
`transform_y`	否	`0`	Y 轴位置偏移
`scale_x`	否	`1`	X 轴缩放比例
`scale_y`	否	`1`	Y 轴缩放比例
`transform_x`	否	`0`	X 轴位置偏移
`track_name`	否	`'image_main'`	目标轨道名称
`relative_index`	否	`0`	轨道叠加顺序
`animation`	否	—	组合动画名称
`animation_duration`	否	`0.5`	组合动画时长，单位秒
`intro_animation`	否	—	入场动画名称
`intro_animation_duration`	否	`0.5`	入场动画时长，单位秒
`outro_animation`	否	—	出场动画名称
`outro_animation_duration`	否	`0.5`	出场动画时长，单位秒
`combo_animation`	否	—	组合动画名称
`combo_animation_duration`	否	`0.5`	组合动画时长，单位秒
`transition`	否	—	转场名称；先查询 get_transition_types
`transition_duration`	否	`0.5`	转场时长，单位秒
`mask_type`	否	—	蒙版名称；先查询 get_mask_types
`mask_center_x`	否	`0.0`	蒙版中心 X 坐标
`mask_center_y`	否	`0.0`	蒙版中心 Y 坐标
`mask_size`	否	`0.5`	蒙版大小
`mask_rotation`	否	`0.0`	蒙版旋转角度
`mask_feather`	否	`0.0`	蒙版羽化程度
`mask_invert`	否	`False`	是否反转蒙版
`mask_rect_width`	否	—	矩形蒙版宽度
`mask_round_corner`	否	—	矩形蒙版圆角，范围 0-100
`background_blur`	否	—	背景模糊级别，可选 1-4

调用示例

bash

curl -X POST https://your-domain.example/api/add_image \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $VECTCUT_API_KEY" \
  -d '{
    "draft_id": "dfd_cat_demo_001",
    "image_url": "https://example.com/cover.png",
    "start": 0,
    "end": 3,
    "intro_animation": "缩小",
    "transition": "_3D空间",
    "mask_type": "圆形",
    "mask_center_x": 0.5,
    "mask_center_y": 0.5,
    "mask_size": 0.5
  }'

返回格式

json

{
  "success": true,
  "output": {
    "draft_id": "dfd_cat_demo_001",
    "draft_url": "https://your-domain.example/api/draft/downloader?draft_id=dfd_cat_demo_001"
  },
  "error": ""
}

add_image ​

接口说明 ​

请求参数 ​

调用示例 ​

返回格式 ​

add_image

接口说明

请求参数

调用示例

返回格式