Tạo lời bài hát

Tạo các phương án lời bài hát dựa trên lời nhắc và lấy kết quả qua truy vấn tác vụ.

Sau khi gửi thành công, lưu data.jobId và lấy các phương án lời bài hát qua Truy vấn tác vụ. lyrics_model hỗ trợ classic và remi; dùng classic khi bỏ qua.

Khi truy vấn cho biết tác vụ đã hoàn tất, các phương án lời bài hát nằm tại data.data.data.lyrics trong phản hồi. Mỗi phần tử trả về toàn bộ lời bài hát trong prompt, kèm title và tags; không đọc trường text không được trả về.

POST/suno/mj/submit/lyrics

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.

prompt*string

Lời nhắc tạo lời bài hát, tối đa 500 ký tự.

Độ dàilength <= 500

lyrics_model?string

Mô hình lời bài hát; hỗ trợ classic và remi, mặc định classic.

Giá trị mặc định"classic"

Giá trị được phép

"classic"
"remi"

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/lyrics' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Viết lời nhạc pop bằng tiếng Trung về cuộc tái ngộ bên bờ biển trong đêm hè, với điệp khúc dễ nhớ",
  "lyrics_model": "classic"
}'

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

429application/json

`application/json`

`application/json`

`application/json`