Tạo bài hát

Gửi tác vụ tạo âm nhạc mới, hỗ trợ chế độ cảm hứng, chế độ tùy chỉnh và nhạc không lời.

Phải truyền rõ ràng custom và instrumental. Khi custom=false, điền gpt_description_prompt; khi custom=true và instrumental=false, điền prompt.

Sau khi gửi, lưu data.jobId và đọc kết quả qua Truy vấn tác vụ. Quy tắc callback được trình bày trong phần “Thông báo callback” của trang đó.

POST/suno/mj/submit/music

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.

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.

instrumental*boolean

Có tạo nhạc không lời 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 và instrumental=false.

title?string

Tiêu đề bài hát, tối đa 80 ký tự.

Độ dàilength <= 80

tags?string

Phong cách/thẻ.

negative_tags?string

Thẻ loại trừ.

style_weight?number

Phạm vi giá trị từ 0~1.

Phạm vi0 <= value <= 1

weirdness_constraint?number

Phạm vi giá trị từ 0~1.

Phạm vi0 <= value <= 1

audio_weight?number

Phạm vi giá trị từ 0~1.

Phạm vi0 <= value <= 1

auto_lyrics?boolean

Có tự động tạo lời bài hát hay không.

vocal_gender?string

Chỉ hỗ trợ Male / Female.

Giá trị được phép

"Male"
"Female"

persona_id?string

Persona ID。

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/music' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "custom": true,
  "instrumental": false,
  "mv": "chirp-v5",
  "prompt": "Viết một bài folk-pop ấm áp, phần verse nhẹ nhàng và điệp khúc dễ nhớ",
  "title": "Dusk on Elm",
  "tags": "gentle, acoustic pop"
}'

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

401application/json

`application/json`

`application/json`

`application/json`