add_audio

POST /add_audio

接口说明

向草稿添加音频或背景音乐，并设置源区间、时间轴位置、音量、速度和音频特效。服务端只保存音频 URL，不下载音频文件。音频特效名称先用 get_audio_effect_types 查询。

请求参数

参数	必填	默认值	说明
draft_folder	否	—	草稿输出目录；本地部署时可指定剪映草稿根目录
audio_url	是	—	远程音频 URL；服务端只保存 URL，不下载音频
start	否	0	源素材开始时间，单位秒
end	否	None	源素材结束时间，单位秒
draft_id	否	—	草稿 ID；省略时创建新草稿
volume	否	1.0	音量，1.0 为原始音量
target_start	否	0	放到时间轴上的开始时间，单位秒
speed	否	1.0	播放速度，1.0 为原速
track_name	否	'audio_main'	目标轨道名称
duration	否	None	素材总时长，单位秒；建议先用 get_duration 获取
effect_type	否	None	特效名称
effect_params	否	None
width	否	1080	画布或素材宽度
height	否	1920	画布或素材高度

调用示例

curl -X POST https://your-domain.example/api/add_audio \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $VECTCUT_API_KEY" \
  -d '{
    "draft_id": "dfd_cat_demo_001",
    "audio_url": "https://example.com/music.mp3",
    "start": 0,
    "end": 30,
    "target_start": 0,
    "duration": 30,
    "volume": 0.8,
    "effect_type": "台湾小哥",
    "effect_params": []
  }'

返回格式

{
  "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": ""
}