添加人声

先通过上传参考音频取得音轨 ID，再将其填入 music_id。生成歌曲返回的音轨 ID 不适用于此操作。

custom=true 时，prompt 为歌词或人声提示。提交成功后保存 data.jobId，再通过查询任务等待结果；提交响应中的 status: SUCCESS 不表示音频已生成完成。

POST/suno/mj/submit/add-vocals

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。生成歌曲返回的音轨 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-vocals' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "music_id": "MUSIC_ID",
  "custom": true,
  "mv": "chirp-v5",
  "prompt": "为这段旋律添加温暖的中文女声主歌和副歌",
  "title": "Voice Layer",
  "tags": "mandopop, female vocal",
  "vocal_gender": "Female"
}'

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

Authorization

Request Body

Response Body

200application/json

400application/json

`application/json`

`application/json`