Tải lên âm thanh tham chiếu

Gửi URL âm thanh tham chiếu có thể truy cập công khai để lấy ID bản nhạc dùng cho cover, viết tiếp hoặc thêm giọng hát.

API này nhận audio_url trong JSON, không phải tải lên tệp Multipart. Dùng is_async để chọn xử lý đồng bộ hoặc bất đồng bộ.

POST/suno/mj/submit/upload

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.

audio_url*string

Địa chỉ âm thanh có thể truy cập công khai.

is_async?boolean

Có tải lên bất đồng bộ hay không; mặc định false. Thành công đồng bộ thường trả về music_id trực tiếp.

Giá trị mặc địnhfalse

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/upload' \
  --header 'Authorization: Bearer your-api-key' \
  --header 'Content-Type: application/json' \
  --data '{
  "audio_url": "https://example.com/reference-vocal.wav",
  "is_async": false
}'

{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "music_id": "MUSIC_ID"
  }
}

Xử lý kết quả tải lên

Tải lên đồng bộ: is_async=false (mặc định); khi thành công, đọc ID bản nhạc từ data.music_id.
Tải lên bất đồng bộ: is_async=true; sau khi gửi thành công, lưu data.jobId và chờ tác vụ hoàn tất qua Truy vấn tác vụ. ID bản nhạc sau khi hoàn tất nằm tại data.data.data.musics[].musicId.

status: SUCCESS trong phản hồi bất đồng bộ chỉ cho biết tác vụ đã được tiếp nhận, không có nghĩa việc xử lý tải lên đã hoàn tất. Điền ID bản nhạc vào music_id của Cover theo phong cách, Viết tiếp bài hát hoặc Thêm giọng hát; ID tác vụ không thể thay thế ID bản nhạc.

Tải lên âm thanh tham chiếu

Xác thực

Nội dung yêu cầu

Nội dung phản hồi

200application/json

400application/json

Xử lý kết quả tải lên

`application/json`

`application/json`