Cover theo phong cách

Chuyển đổi phong cách âm nhạc, lời bài hát hoặc chất giọng dựa trên ID bản nhạc có sẵn hoặc lấy từ bước tải lên âm thanh tham chiếu.

Trước tiên, lấy ID bản nhạc qua Tải lên âm thanh tham chiếu, hoặc dùng ID bản nhạc có sẵn, rồi điền vào music_id. Sau khi gửi, đọc kết quả qua Truy vấn tác vụ.

POST/suno/mj/submit/cover

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 cần cover, có thể lấy từ API tải lên âm thanh tham chiếu.

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"

persona_id?string

Persona ID。

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/cover' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "music_id": "MUSIC_ID",
  "custom": false,
  "mv": "chirp-v5",
  "gpt_description_prompt": "Chuyển âm thanh tham chiếu này sang phong cách synth-pop retro với giọng nữ, giữ nét giai điệu dễ nhớ",
  "title": "Neon Cover",
  "tags": "synth-pop, retro, female vocal"
}'

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

`application/json`