添加伴奏
Generate Music
添加伴奏
通过为上传的音频文件添加伴奏元素，生成现有音乐曲目的伴奏版本
POST
添加伴奏
使用指南
- 此接口通过添加伴奏元素来增强现有的音频曲目
- 接受上传的音频文件，并根据您的规格生成伴奏版本
- 上传的音频必须可公开访问且采用支持的格式（MP3、WAV等）
参数详情
- 必需字段：
uploadUrl、title、negativeTags、tags、callBackUrl - uploadUrl：必须是有效的、可公开访问的音频文件URL
- title：用作生成的伴奏曲目的标题
- tags：描述伴奏曲目所需的风格、情绪和乐器
- negativeTags：要从生成的伴奏中排除的音乐风格或特征
可选参数
以下字段是此接口可用的可选控制：
- vocalGender (string)：任何人声元素的首选性别。允许的值：
m（男性）、f（女性） - styleWeight (number)：范围0-1的风格权重（建议两位小数）
- weirdnessConstraint (number)：范围0-1的创意/新颖性约束（建议两位小数）
- audioWeight (number)：范围0-1的音频一致性相对权重（建议两位小数）
- model (string)：用于生成的模型版本。可选值：
V4_5PLUS（默认）、V5
开发者注意事项
- 回调过程有三个阶段：
text（文本生成）、first（第一轨道完成）、complete（所有轨道完成） - 在某些情况下，
text和first阶段可能被跳过，直接返回complete - 详细回调格式请参见添加伴奏回调
- 使用获取音乐生成详情监控任务进度
Authorizations
🔑 API 认证说明
所有接口都需要通过 Bearer Token 方式进行认证。
获取 API Key
- 访问 API Key 管理页面 获取您的 API Key
使用方式
在请求头中添加：
Authorization: Bearer YOUR_API_KEY⚠️ 注意：
- 请妥善保管您的 API Key，不要泄露给他人
- 如果怀疑 API Key 泄露，请立即在管理页面重置
Body
application/json
要添加伴奏的上传音乐文件的URL。必须是系统可以访问的有效音频文件URL。上传的音频应该采用支持的格式（MP3、WAV等）。
Example:
"https://example.com/music.mp3"
音乐曲目的标题。这将作为生成的伴奏曲目的标题。
Example:
"轻松钢琴"
要从生成的伴奏中排除的音乐风格或特征。用于避免伴奏版本中的特定风格或乐器。
Example:
"重金属, 激进鼓声"
伴奏的音乐风格和特征。描述伴奏曲目所需的风格、情绪和乐器。
Example:
"轻松钢琴, 环境音乐, 平静"
当伴奏生成完成时接收任务完成通知的URL。回调过程分为三个阶段：text、first、complete。在某些情况下，text和first阶段可能被跳过，直接返回complete。
Example:
"https://api.example.com/callback"
任何人声元素的首选性别。可选。允许的值：m（男性）、f（女性）。
可用选项:
m, f Example:
"m"
风格权重。可选。范围：0-1。建议保留两位小数。
必填范围:
0 <= x <= 1Must be a multiple of 0.01Example:
0.61
创意/新颖性约束。可选。范围：0-1。建议保留两位小数。
必填范围:
0 <= x <= 1Must be a multiple of 0.01Example:
0.72
音频一致性与其他控制的相对权重。可选。范围：0-1。建议保留两位小数。
必填范围:
0 <= x <= 1Must be a multiple of 0.01Example:
0.65
用于生成的模型版本。可选。默认值：V4_5PLUS。
可用选项:
V4_5PLUS, V5 Example:
"V4_5PLUS"
Response
请求成功
状态码说明
- ✅ 200 - 请求成功
- ⚠️ 400 - 参数错误
- ⚠️ 401 - 没有访问权限
- ⚠️ 404 - 请求方式或者路径错误
- ⚠️ 405 - 调用超过限制
- ⚠️ 413 - 主题或者prompt过长
- ⚠️ 429 - 积分不足
- ⚠️ 430 - 您的调用频率过高。请稍后再试。
- ⚠️ 455 - 网站维护
- ❌ 500 - 服务器异常
可用选项:
200, 400, 401, 404, 405, 413, 429, 430, 455, 500 Example:
200
当 code != 200 时，展示错误信息
Example:
"success"