Thêm giọng hát

Trước tiên, lấy ID bản nhạc qua Tải lên âm thanh tham chiếu, rồi điền vào music_id. ID bản nhạc trả về từ thao tác tạo bài hát không dùng được cho thao tác này.

Khi custom=true, prompt là lời bài hát hoặc lời nhắc giọng hát. Sau khi gửi thành công, lưu data.jobId và chờ kết quả qua Truy vấn tác vụ; status: SUCCESS trong phản hồi gửi tác vụ không có nghĩa âm thanh đã được tạo xong.

POST/suno/mj/submit/add-vocals

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 bản nhạc lấy từ bước tải lên âm thanh tham chiếu. ID bản nhạc trả về từ thao tác tạo bài hát không dùng được cho thao tác này.

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, dùng làm lời bài hát hoặc lời nhắc giọng hát.

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-vocals' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "music_id": "MUSIC_ID",
  "custom": true,
  "mv": "chirp-v5",
  "prompt": "Thêm phần verse và điệp khúc bằng tiếng Trung với giọng nữ ấm áp vào giai điệu này",
  "title": "Voice Layer",
  "tags": "mandopop, female vocal",
  "vocal_gender": "Female"
}'

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