POST
/
api
/
v1
/
generate
/
add-instrumental
{
  "uploadUrl": "https://example.com/music.mp3",
  "title": "轻松钢琴",
  "negativeTags": "重金属, 激进鼓声",
  "tags": "轻松钢琴, 环境音乐, 平静",
  "callBackUrl": "https://api.example.com/callback",
  "vocalGender": "m",
  "styleWeight": 0.61,
  "weirdnessConstraint": 0.72,
  "audioWeight": 0.65
}

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

​
使用指南

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

​
参数详情

  • 必需字段：uploadUrl、title、negativeTags、tags、callBackUrl
  • 上传URL：必须是有效的、可公开访问的音频文件URL
  • 标题：用作生成的伴奏曲目的标题
  • 标签：描述伴奏曲目所需的风格、情绪和乐器
  • 负向标签：要从生成的伴奏中排除的音乐风格或特征

​
可选参数

以下字段是此接口可用的可选控制：
  • vocalGender (string)：任何人声元素的首选性别。允许的值：m（男性）、f（女性）
  • styleWeight (number)：范围0-1的风格权重（建议两位小数）
  • weirdnessConstraint (number)：范围0-1的创意/新颖性约束（建议两位小数）
  • audioWeight (number)：范围0-1的音频一致性相对权重（建议两位小数）
{
  "uploadUrl": "https://example.com/music.mp3",
  "title": "轻松钢琴",
  "negativeTags": "重金属, 激进鼓声",
  "tags": "轻松钢琴, 环境音乐, 平静",
  "callBackUrl": "https://api.example.com/callback",
  "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.