加入伴奏

將上傳參考音訊取得的音軌 ID 填入 music_id。生成歌曲等其他來源的音軌 ID 可能不適用於此操作。提交後儲存 data.jobId，並透過查詢任務取得處理狀態與最終音訊。

POST/suno/mj/submit/add-instrumental

授權

bearerAuth

授權Bearer <token>

使用 Authorization: Bearer your-api-key 進行認證。

傳遞位置: header

請求主體

application/json

TypeScript 型別定義

在 TypeScript 中使用 request body 型別。

music_id*string

要加入伴奏的音訊 ID。

custom*boolean

是否使用自訂模式；未傳入時會遭拒絕。

mv?string

音樂模型版本；未填寫時使用 chirp-v5。

預設值"chirp-v5"

可用值

"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 個字元。

長度length <= 500

prompt?string

custom=true 時必填。

title?string

標題，長度上限為 80 個字元。

長度length <= 80

tags?string

音樂風格。

negative_tags?string

負向標籤。

style_weight?number

取值範圍皆為 0~1。

範圍0 <= value <= 1

weirdness_constraint?number

取值範圍皆為 0~1。

範圍0 <= value <= 1

audio_weight?number

取值範圍皆為 0~1。

範圍0 <= value <= 1

vocal_gender?string

僅支援 Male / Female。

可用值

"Male"
"Female"

isStorage?boolean

是否另存。

hookUrl?string

選用的使用者回呼網址。僅支援 80、443、8080、8443 連接埠；填寫後由平台轉送通知。

回應主體

`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"
  }
}

授權

請求主體

回應主體

200application/json

400application/json

`application/json`

`application/json`