功能简介
添加音频素材到草稿，支持音频的裁剪、音量调整、播放速度、音效、淡入淡出等功能。可以为视频添加背景音乐、音效或配音。
使用场景
- 需要为视频添加背景音乐
- 需要添加音效或配音
- 需要裁剪音频的特定片段
- 需要调整音频的音量和播放速度
参数说明
输入参数
基础参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 音频路径或URL | 字符串 | 是 | 音频文件的网络URL或本地文件路径。支持两种方式： 1. 网络URL：直接提供可访问的音频链接 2. 本地路径：提供本地音频文件的绝对路径或相对路径，系统会自动上传（最大100MB） |
| 起始截取时间 | 小数 | 否 | 从音频的哪个时间点开始截取，单位：秒，默认0表示从头开始 |
| 结束截取时间 | 小数 | 否 | 截取到音频的哪个时间点，单位：秒。不填表示截取到音频结尾 |
| 起始位置 | 小数 | 否 | 音频在时间线上的起始位置，单位：秒，默认0表示从开头开始 |
| 草稿ID | 字符串 | 否 | 目标草稿的ID，不填则创建新草稿 |
音频参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 音量 | 小数 | 否 | 音频音量，单位：db，0.0为原始音量，-100为静音，负值表示降低音量，正值表示提高音量 |
| 音频速度 | 小数 | 否 | 音频播放速度，1.0为正常速度，大于1.0为快放，小于1.0为慢放 |
| 轨道名称 | 字符串 | 否 | 音频所在的轨道名称，默认audio_main。设置为main则位于主轨道 |
| 素材时长 | 小数 | 否 | 音频的原始时长，单位：秒。提供此参数可跳过自动检测，提高处理速度 |
| 音效类型 | 字符串 | 否 | 音频特效类型，通过【获取音频特效类型】指令来获取 |
| 音效参数列表 | 列表 | 否 | 音频特效的参数列表，整数列表格式，如[35,45]。不同音效可能有不同的参数要求 |
| 淡入时间 | 小数 | 否 | 音频淡入的持续时间，单位：秒。实现音量从0逐渐增加到正常音量 |
| 淡出时间 | 小数 | 否 | 音频淡出的持续时间，单位：秒。实现音量从正常音量逐渐降低到0 |
画布参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 视频宽度 | 整数 | 否 | 画布的宽度，单位：像素。仅在创建新草稿时需要指定 |
| 视频高度 | 整数 | 否 | 画布的高度，单位：像素。仅在创建新草稿时需要指定 |
输出参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 返回草稿ID | 字符串 | 是 | 操作后的草稿ID |
| 草稿URL | 字符串 | 是 | 草稿的访问链接 |
注意事项
音频路径或URL：
- 网络URL：必须是可公开访问的链接，不能是私有链接或需要认证的链接
- 本地文件：支持绝对路径和相对路径，文件大小最大100MB
- 本地文件会自动上传到临时图床，上传后的URL有效期根据图床服务而定
时间参数：起始截取时间必须小于结束截取时间，且不能超过音频的实际时长
淡入淡出：淡入时间和淡出时间用于实现音频的平滑开始和结束，避免突然出现或消失
草稿ID：如果不提供草稿ID，系统会自动创建新草稿，后续操作需要使用返回的草稿ID
使用示例
使用网络URL：
python
音频路径或URL = "（填写可公网访问的音频地址）"使用本地文件路径：
python
音频路径或URL = "/Users/username/Music/audio.mp3"
# 或相对路径
音频路径或URL = "./audios/audio.mp3"