Truy vấn tác vụ
Truy vấn trạng thái và kết quả tác vụ Suno MJ theo ID tác vụ. Các loại tác vụ trả về các trường kết quả khác nhau.
Dùng ID tác vụ trả về từ API gửi tác vụ để truy vấn trạng thái và kết quả.
/suno/mj/fetch/{job_id}Xác thực
bearerAuth Xác thực bằng Authorization: Bearer your-api-key.
Vị trí truyền: header
Tham số đường dẫn
ID tác vụ trả về từ API gửi tác vụ; đọc jobId hoặc job_id theo phản hồi tương ứng, không phải ID bản nhạc.
Nội dung phản hồi
application/json
application/json
application/json
ID tác vụ và ID bản nhạc
| Mã định danh | Mục đích |
|---|---|
jobId / job_id | ID tác vụ, dùng để truy vấn trạng thái và kết quả; đọc theo phản hồi thực tế của API gửi tác vụ tương ứng. |
music_id / musicId | ID bản nhạc, dùng cho cover, viết tiếp, thêm giọng hát hoặc thêm nhạc đệm. |
Tải lên âm thanh tham chiếu hỗ trợ cả đồng bộ lẫn bất đồng bộ. Thành công đồng bộ trả về ID bản nhạc trực tiếp; sau khi tải lên bất đồng bộ hoàn tất, ID bản nhạc nằm tại data.data.data.musics[].musicId trong phản hồi truy vấn. Không dùng ID bản nhạc làm ID tác vụ để truy vấn. Có thể dùng Truy vấn tác vụ hàng loạt cho nhiều tác vụ.
Trạng thái và kết quả
| Trạng thái | Ý nghĩa |
|---|---|
NOT_START | Tác vụ đã được tạo, chưa bắt đầu xử lý. |
QUEUED | Tác vụ đang xếp hàng. |
ON_QUEUE | Đang xếp hàng. |
SUCCESS | Tác vụ thành công; đọc kết quả theo loại tương ứng. |
FAILED | Tác vụ thất bại; xem thông tin lỗi trả về trong tác vụ. |
status: SUCCESS trong phản hồi gửi tác vụ biểu thị yêu cầu đã được tiếp nhận thành công, không có nghĩa tác vụ bất đồng bộ đã hoàn tất. code: success ở lớp ngoài cùng của phản hồi truy vấn biểu thị yêu cầu truy vấn thành công; đọc trạng thái tác vụ từ data.status. Khi tác vụ tạo âm nhạc hoặc tải lên bất đồng bộ hoàn tất, các bản nhạc nằm tại data.data.data.musics[]. musicId của mỗi bản nhạc dùng cho các thao tác sau đó; audioUrl trỏ tới âm thanh; title có thể là null nếu không có tiêu đề. Các loại tác vụ khác có thể có trường kết quả khác, không được áp dụng trực tiếp cấu trúc này.
Thông báo callback
Khi gửi yêu cầu, có thể điền hookUrl để nhận thông báo tác vụ do nền tảng chuyển tiếp. Địa chỉ callback chỉ hỗ trợ các cổng 80, 443, 8080 và 8443.
Khi không điền hookUrl, có thể chủ động truy vấn tác vụ; việc cập nhật trạng thái có thể có độ trễ. Dù đã cấu hình callback, vẫn có thể dùng API truy vấn để lấy kết quả. Cấu hình callback được xác định bởi hookUrl trong yêu cầu gửi tác vụ; không dùng data.hookUrl trong phản hồi truy vấn để xác định địa chỉ callback.