生成混音音乐
生成混音音乐
使用AI模型通过组合多个音频轨道创建混音音乐。
POST
生成混音音乐
使用指南
- 此接口从最多2个上传的音频文件创建混音音乐
- 将多个轨道的元素组合成一个连贯的新作品
- 您可以通过自定义模式和纯音乐设置来控制细节级别
参数详情
-
uploadUrlList是必需的，必须包含恰好2个音频文件URL -
自定义模式下（
customMode: true）:- 不同模型的
prompt字符限制：- V4：
prompt3000字符，style200字符 - V4_5 和 V4_5PLUS：
prompt5000字符，style1000字符 - V4_5ALL：
prompt5000字符，style1000字符 - V5：
prompt5000字符，style1000字符
- V4：
title长度限制：80字符（所有模型）
- 不同模型的
-
非自定义模式下（
customMode: false）:prompt长度限制：500字符instrumental: 是否生成纯音乐- 其他参数应留空
开发者注意事项
- 新用户建议：以
customMode: false开始使用，更简单 - 生成的文件将保留14天
- 回调过程分三个阶段：
text（文本生成）、first（第一首完成）、complete（全部完成） - 上传的音频文件必须是可公开访问的URL
uploadUrlList必须包含恰好2个音频文件URL才能进行混音生成
可选参数
vocalGender（string）: 人声性别偏好。m男声，f女声。注意：此参数仅在customMode为true时生效。根据实践，此参数只能加强概率，但不能保证一定遵循男女声的指令。styleWeight（number）: 对风格的遵循强度。注意：此参数仅在customMode为true时生效。范围 0–1，保留两位小数。示例：0.61。weirdnessConstraint（number）: 创意/离散程度。注意：此参数仅在customMode为true时生效。范围 0–1，保留两位小数。示例：0.72。audioWeight（number）: 音频要素权重。注意：此参数仅在customMode为true时生效。范围 0–1，保留两位小数。示例：0.65。
授权
所有接口都需要通过 Bearer Token 方式进行认证。
获取 API Key:
- 访问 API Key 管理页面 获取您的 API Key
使用方式: 在请求头中添加： Authorization: Bearer YOUR_API_KEY
注意事项：
- 请妥善保管您的 API Key，不要泄露给他人
- 如果怀疑 API Key 泄露，请立即在管理页面重置
请求体
application/json
要混音的音频文件URL数组。必须包含恰好2个URL。每个URL必须是可公开访问的。
Required array length:
2 elements示例:
[
"https://example.com/audio1.mp3",
"https://example.com/audio2.mp3"
]确定是否启用高级参数自定义。
- 如果为
true：允许详细控制，对style和title字段有特定要求。 - 如果为
false：简化模式，只需要prompt，其他参数将被忽略。
示例:
true
用于生成的AI模型版本。
- 所有请求都必填。
- 可用选项：
V5： 更卓越的音乐表现力，生成速度更快。V4_5PLUS：V4.5+ 的音色更丰富，新的创作方式，最长8分钟。V4_5：V4.5 更智能的提示词，更快的生成速度，最长8分钟。V4_5ALL：V4.5ALL 更智能的提示词，更快的生成速度，最长8分钟。V4：V4 改进的人声质量，最长4分钟。
可用选项:
V4, V4_5, V4_5PLUS, V4_5ALL, V5 示例:
"V4"
用于接收音乐生成任务完成更新的URL地址。所有音乐生成请求都需要此参数。
- 系统将在音乐生成完成时向此URL发送POST请求，包含任务状态和结果
- 回调过程有三个阶段：
text（文本生成）、first（第一个音轨完成）、complete（所有音轨完成） - 注意：某些情况下可能会跳过
text和first阶段，直接返回complete - 您的回调端点应能接受包含音乐生成结果的JSON载荷的POST请求
- 详细的回调格式和实现指南，请参见 音乐生成回调
- 或者，您也可以使用获取音乐详情接口来轮询任务状态
- 为确保回调安全性，请参阅 Webhook 校验指南 了解签名验证实现方法
示例:
"https://example.com/callback"
描述所需音频内容的提示词。
- 自定义模式下（
customMode: true）：必填。提示词将严格作为歌词使用并在生成的音轨中演唱。不同模型的字符限制：- V4：最多3000字符
- V4_5 和 V4_5PLUS：最多5000字符
- V4_5ALL：最多5000字符
- V5：最多5000字符
示例："一段平静舒缓的钢琴曲，带有柔和的旋律"
- 非自定义模式下（
customMode: false）：始终必填。提示词作为核心创意，歌词将根据它自动生成（不严格匹配输入），最多500字符。
示例："一段简短放松的钢琴曲"
示例:
"A calm and relaxing piano track with soft melodies"
生成音频的音乐风格规范。
- 仅在自定义模式（
customMode: true）下可用且必填。定义流派、情绪或艺术方向。 - 不同模型的字符限制：
- V4：最多200字符
- V4_5 和 V4_5PLUS：最多1000字符
- V4_5ALL：最多1000字符
- V5：最多1000字符
- 常见示例：爵士乐、古典乐、电子乐、流行乐、摇滚乐、嘻哈等。
示例:
"Jazz"
生成音乐曲目的标题。
- 仅在自定义模式（
customMode: true）下可用且必填。 - 最大长度：80字符。
- 将显示在播放器界面和文件名中。
示例:
"Relaxing Piano"
确定音频是否为纯音乐（无歌词）。
- 仅在非自定义模式（
customMode: false）下可用。 - 在自定义模式下此参数不可用。
示例:
true
人声性别偏好。
- 仅在自定义模式（
customMode: true）下可用。可选。使用 'm' 表示男声，'f' 表示女声。根据实践，此参数只能增加概率，但不能保证遵循男女声指令。
可用选项:
m, f 示例:
"m"
对指定风格的遵循强度。
- 仅在自定义模式（
customMode: true）下可用。可选。范围 0–1，保留2位小数。
必填范围:
0 <= x <= 1必须是以下数值的倍数 0.01示例:
0.61
控制实验性/创意偏差。
- 仅在自定义模式（
customMode: true）下可用。可选。范围 0–1，保留2位小数。
必填范围:
0 <= x <= 1必须是以下数值的倍数 0.01示例:
0.72
音频特征与其他因素的平衡权重。
- 仅在自定义模式（
customMode: true）下可用。可选。范围 0–1，保留2位小数。
必填范围:
0 <= x <= 1必须是以下数值的倍数 0.01示例:
0.65
响应
请求成功
响应状态码
- 200: 成功 - 请求已成功处理
- 401: 未授权 - 认证凭据缺失或无效
- 402: 积分不足 - 账户没有足够的积分来执行此操作
- 404: 未找到 - 请求的资源或端点不存在
- 409: 冲突 - WAV记录已存在
- 422: 验证错误 - 请求参数验证失败
- 429: 速率限制 - 此资源的请求限制已超出
- 451: 未授权 - 无法获取图像。请验证您或您的服务提供商设置的任何访问限制
- 455: 服务不可用 - 系统正在进行维护
- 500: 服务器错误 - 处理请求时发生意外错误
可用选项:
200, 401, 402, 404, 409, 422, 429, 451, 455, 500 当 code != 200 时的错误消息
示例:
"success"