剪映API视频合成#

快速开始#

0. 上传素材（可选）#

如果素材不在OSS上，先上传：

json

POST https://np-newsmgr-uat.eastmoney.com/video-admin/api/oss/upload
Content-Type: multipart/form-data

参数： file（文件）、 bucket（桶名称）、 filename（文件名） 返回： ossKey（可拼接素材地址）

1. 创建草稿#

json

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. 导出视频#

json

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决定上下层

素材地址拼接#

text

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