Thêm nhạc đệm

Thêm lớp nhạc đệm vào âm thanh có sẵn, phù hợp khi đã có giọng hát không nhạc đệm hoặc tư liệu giai điệu.

Điền ID bản nhạc lấy từ Tải lên âm thanh tham chiếu vào music_id. ID bản nhạc từ các nguồn khác, chẳng hạn thao tác tạo bài hát, có thể không dùng được cho thao tác này. Sau khi gửi, lưu data.jobId và lấy trạng thái xử lý cùng âm thanh cuối cùng qua Truy vấn tác vụ.

POST/suno/mj/submit/add-instrumental

Xác thực

bearerAuth

Xác thựcBearer <token>

Xác thực bằng Authorization: Bearer your-api-key.

Vị trí truyền: header

Nội dung yêu cầu

application/json

Định nghĩa kiểu TypeScript

Sử dụng kiểu request body trong TypeScript.

music_id*string

ID âm thanh cần thêm nhạc đệm.

custom*boolean

Có sử dụng chế độ tùy chỉnh hay không; yêu cầu bị từ chối nếu không truyền.

mv?string

Phiên bản mô hình âm nhạc; dùng chirp-v5 nếu không điền.

Giá trị mặc định"chirp-v5"

Giá trị được phép

"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

Bắt buộc khi custom=false, tối đa 500 ký tự.

Độ dàilength <= 500

prompt?string

Bắt buộc khi custom=true.

title?string

Tiêu đề, tối đa 80 ký tự.

Độ dàilength <= 80

tags?string

Phong cách âm nhạc.

negative_tags?string

Thẻ loại trừ.

style_weight?number

Các giá trị đều nằm trong phạm vi 0~1.

Phạm vi0 <= value <= 1

weirdness_constraint?number

Các giá trị đều nằm trong phạm vi 0~1.

Phạm vi0 <= value <= 1

audio_weight?number

Các giá trị đều nằm trong phạm vi 0~1.

Phạm vi0 <= value <= 1

vocal_gender?string

Chỉ hỗ trợ Male / Female.

Giá trị được phép

"Male"
"Female"

isStorage?boolean

Có lưu chuyển sang nơi lưu trữ khác hay không.

hookUrl?string

Địa chỉ callback tùy chọn của người dùng. Chỉ hỗ trợ các cổng 80, 443, 8080, 8443; khi điền, nền tảng chuyển tiếp thông báo.

Nội dung phản hồi

`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": "Thêm nhạc đệm acoustic pop ấm áp cho phần hát không nhạc này, tiết chế nhịp trống và mở rộng phần điệp khúc",
  "title": "Acoustic Arrangement",
  "tags": "acoustic pop, warm, soft drums"
}'

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

Xác thực

Nội dung yêu cầu

Nội dung phản hồi

200application/json

400application/json

`application/json`

`application/json`