添加伴奏

为已有音频添加伴奏层，适用于已有清唱或旋律素材的场景。

将上传参考音频得到的音轨 ID 填入 music_id。生成歌曲等其他来源的音轨 ID 可能不适用于此操作。提交后保存 data.jobId，并通过查询任务获取处理状态和最终音频。

POST/suno/mj/submit/add-instrumental

Authorization

bearerAuth

AuthorizationBearer <token>

使用 Authorization: Bearer your-api-key 认证。

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

music_id*string

要添加伴奏的音频 ID。

custom*boolean

是否自定义模式；未传会被拒绝。

mv?string

音乐模型版本；未填写时使用 chirp-v5。

Default"chirp-v5"

Value in

"chirp-v5-5"
"chirp-v5"
"chirp-v4-5+"
"chirp-v4-5"
"chirp-v4-5-all"
"chirp-v4"
"chirp-v3-5"
"chirp-v3-0"

gpt_description_prompt?string

custom=false 时必填，长度上限 500 字符。

Lengthlength <= 500

prompt?string

custom=true 时必填。

title?string

标题，长度上限 80 字符。

Lengthlength <= 80

tags?string

音乐风格。

negative_tags?string

负向标签。

style_weight?number

取值范围均为 0~1。

Range0 <= value <= 1

weirdness_constraint?number

取值范围均为 0~1。

Range0 <= value <= 1

audio_weight?number

取值范围均为 0~1。

Range0 <= value <= 1

vocal_gender?string

仅支持 Male / Female。

Value in

"Male"
"Female"

isStorage?boolean

是否转存。

hookUrl?string

可选的用户回调地址。仅支持 80、443、8080、8443 端口；填写后由平台转发通知。

Response Body

`application/json`

curl --request POST 'https://api.agtcloud.cn/suno/mj/submit/add-instrumental' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "music_id": "MUSIC_ID",
  "custom": false,
  "mv": "chirp-v5",
  "gpt_description_prompt": "为这段清唱添加温暖的 acoustic pop 伴奏，鼓点克制，副歌铺开",
  "title": "Acoustic Arrangement",
  "tags": "acoustic pop, warm, soft drums"
}'

{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "jobId": "JOB_ID"
  }
}

Authorization

Request Body

Response Body

200application/json

400application/json

`application/json`

`application/json`