add_preset

添加预设片段

1. 什么是预设片段

预设片段，是你提前在剪映里编辑好的”图片、视频、文字、关键帧、动画等等”的预设模版。你在剪映里编辑好之后，就可以通过我们的客户端上传，并获取preset_id，然后利用当前接口，就可以替换里面的图片、视频、文字、音频。

2. 在什么场景里使用

当你需要制作大量相似的片段，例如字幕、特效、画中画效果的时候，你就可以使用预设替换里面的部分素材。

混剪素材，做素材的随机组合

人物口播，做字幕模版

3. 我能拿到什么结果

如果你不指定draft_id，将会默认生成一个新的草稿

如果你指定了draft_id，将会基于已有草稿继续添加。

4. 常见报错与处理建议

New segment overlaps错误，这表示目标轨道的目标时间范围已经有素材占位了，通常你需要设置track_name将当前预设放到其他轨道。

余额不足，可以去官网充值：https://www.vectcut.com：充值后重试。

5. 一次完整调用流程

选择预设preset_id

确定你要替换的replacements

调用提交接口拿到 draft_id。

curl --location 'https://open.vectcut.com/cut_jianying/add_preset' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "preset_id": "b795a680-a581-4965-84b1-9e9ad313b522", "replacements": [ { "text1": "流光剪辑" }, { "image1": "https://player.install-ai-guider.top/example/mao.webp" }, { "video1": "https://cdn.wanx.aliyuncs.com/wanx/1719234057367822001/text_to_video/092faf3c94244973ab752ee1280ba76f.mp4?spm=5176.29623064.0.0.41ed26d6cBOhV3&file=092faf3c94244973ab752ee1280ba76f.mp4" } ], "target_start": 2, "draft_id": "draft_456", "transform_x": 0.5, "transform_y": 0.5, "rotation": 0, "scale_x": 1.0, "scale_y": 1.0, "track_name": "my_preset_track", "width": 1080, "height": 1920 }'

{ "error": "", "output": { "draft_id": "dfd_cat_1762657936_33c76364", "draft_url": "https://cn.capcutapi.top/draft/downloader?draft_id=dfd_cat_1762657936_33c76364&is_capcut=0&api_key_hash=8d9c14ce4af7ba82880b412d7808f45f4f71fb41188c365fc54dd46d3bfdedf3" }, "purchase_link": "https://www.coze.cn/store/project/7498257920212647946?entity_id=1&bid=6g6miqtbk3009", "success": true }

1. 什么是预设片段

2. 在什么场景里使用

3. 我能拿到什么结果

4. 常见报错与处理建议

5. 一次完整调用流程

请求参数

返回响应

add_preset

1. 什么是预设片段#

2. 在什么场景里使用#

3. 我能拿到什么结果#

4. 常见报错与处理建议#

5. 一次完整调用流程#

请求参数

返回响应

1. 什么是预设片段

2. 在什么场景里使用

3. 我能拿到什么结果

4. 常见报错与处理建议

5. 一次完整调用流程