剪映API视频合成
快速开始
0. 上传素材(可选)
如果素材不在OSS上,先上传:
POST https://np-newsmgr-uat.eastmoney.com/video-admin/api/oss/upload
Content-Type: multipart/form-data
参数:file(文件)、bucket(桶名称)、filename(文件名)
返回:ossKey(可拼接素材地址)
1. 创建草稿
POST https://np-newsmgr-uat.eastmoney.com/videomake/api/capcut-proxy/create_draft
{"width": 1080, "height": 1920}
返回 draft_id
2. 添加素材
- 图片:
add_image - 背景图、产品图
- 视频:
add_video - 视频片段
- 音频:
add_audio - 背景音乐、音效
- 文本:
add_text / add_subtitle - 标题、字幕
3. 导出视频
POST https://np-newsmgr-uat.eastmoney.com/videomake/api/capcut-proxy/export_draft
{"draft_id": "xxx", "resolution": "1080P", "framerate": 30}
⚠️ 注意: 导出视频是云渲染过程,平均耗时约 80秒,请耐心等待返回的 video_file_url
核心概念
relative_index 图层顺序
- 值越小越在下层,值越大越在上层
- 背景图用
relative_index: 0(最底层)
- 文字/图片/视频用
relative_index: 1,2,3...(在上层)
track_name 轨道概念
- 相同时间段内,同一轨道(相同track_name)后者覆盖前者
- 不同轨道可叠加显示,按relative_index决定上下层
素材地址拼接
http://np-newsmgr-uat.emapd.com/videomake/api/resource/download/bucket?filename={ossKey}&bucket={bucket}
- 默认bucket:
np-vediooss-material
常用配置
字幕默认配置
- 字体: 抖音美好体
- 字号: 10
- 位置: transform_y: -0.42(底部居中)
- 颜色: #FFFFFF
- 入场动画: 放大,0.5秒
- 出场动画: 缩小,0.5秒
可用字体
抖音美好体、思源黑体、OPPO Sans、挥墨体、文轩体、鸿蒙OS、小米MiSans、站酷快乐体
文本动画
放大、缩小、渐显、溶解、打字机、弹性伸缩、弹簧、闪光、旋转飞入、模糊发光、逐字弹跳
详细参数
完整API参数说明见 references/api_reference.md