POST
/
api
/
v1
/
generate
/
add-vocals
{
  "uploadUrl": "https://example.com/instrumental.mp3",
  "callBackUrl": "https://api.example.com/callback",
  "prompt": "带有舒缓人声的平静放松钢琴曲",
  "title": "带人声的轻松钢琴",
  "negativeTags": "重金属, 激进人声",
  "style": "爵士",
  "vocalGender": "m",
  "styleWeight": 0.61,
  "weirdnessConstraint": 0.72,
  "audioWeight": 0.65
}

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "5c79****be8e"
  }
}

​
使用指南

  • 此接口通过添加人声元素来增强器乐曲目
  • 接受上传的音频文件，并根据您的规格生成人声
  • 上传的音频必须可公开访问且采用支持的格式（MP3、WAV等）

​
参数详情

  • 必需字段：uploadUrl、callBackUrl、prompt、title、negativeTags、style
  • 上传URL：必须是有效的、可公开访问的音频文件URL
  • 风格：描述整体流派和人声方法（爵士、古典、电子、流行）
  • 负向标签：要从生成中排除的音乐风格或人声特征
  • 标题：用作生成的人声曲目的标题

​
可选参数

以下字段是此接口可用的可选控制：
  • vocalGender (string)：首选人声性别。允许的值：m（男性）、f（女性）
  • styleWeight (number)：范围0-1的风格权重（建议两位小数）
  • weirdnessConstraint (number)：范围0-1的创意/新颖性约束（建议两位小数）
  • audioWeight (number)：范围0-1的音频一致性相对权重（建议两位小数）
{
  "uploadUrl": "https://example.com/instrumental.mp3",
  "callBackUrl": "https://api.example.com/callback",
  "prompt": "带有舒缓人声的平静放松钢琴曲",
  "title": "带人声的轻松钢琴",
  "negativeTags": "重金属, 激进人声",
  "style": "爵士",
  "vocalGender": "m",
  "styleWeight": 0.61,
  "weirdnessConstraint": 0.72,
  "audioWeight": 0.65
}

​
开发者注意事项

  • 回调过程有三个阶段：text（文本生成）、first（第一轨道完成）、complete（所有轨道完成）
  • 在某些情况下，text和first阶段可能被跳过，直接返回complete
  • 详细回调格式请参见添加人声回调
  • 使用获取音乐生成详情监控任务进度

Authorizations

​
Authorization
string
header
required

🔑 API 认证说明

所有接口都需要通过 Bearer Token 方式进行认证。

获取 API Key

  1. 访问 API Key 管理页面 获取您的 API Key

使用方式

在请求头中添加：

Authorization: Bearer YOUR_API_KEY

⚠️ 注意：

  • 请妥善保管您的 API Key，不要泄露给他人
  • 如果怀疑 API Key 泄露，请立即在管理页面重置

Body

application/json

Response

200
application/json

请求成功

The response is of type object.