📘 Tài liệu API Suno#
1. Thông tin cơ bản#
📡 Địa chỉ API#
https://{BASE_URL}/suno/submit/music
https://{BASE_URL}/suno/fetch
2. Hỗ trợ mô hình#
✅ Mô hình được hỗ trợ:#
| Mã mô hình | Phiên bản tương ứng |
|---|
| chirp-v3-0 | v3.0 |
| chirp-v3-5 | v3.5 |
| chirp-v4 | v4.0 |
| chirp-auk | v4.5 |
3. Thông báo qua callback#
Hỗ trợ địa chỉ callback thông qua notify_hook
Phương thức yêu cầu: POST
Dữ liệu tiếp nhận: cấu trúc task (nhiệm vụ)
4. Quy trình sử dụng#
🔧 Bước 1: Tạo một nhiệm vụ Suno (tạo bài hát)#
🔍 Bước 2: Kiểm tra tiến độ nhiệm vụ#
5. Cấu trúc dữ liệu#
📦 Đối tượng Task (Nhiệm vụ)#
| Trường | Kiểu | Ví dụ | Mô tả |
|---|
task_id | string | f4a94d75-087b-4bb1-bd45-53ba293faf96 | ID của nhiệm vụ |
action | string | MUSIC | Loại nhiệm vụ: MUSIC (tạo nhạc), LYRICS (tạo lời bài hát) |
status | string | SUCCESS | Trạng thái nhiệm vụ:
NOT_START (chưa bắt đầu)
SUBMITTED (đã gửi xử lý)
QUEUED (đang xếp hàng)
IN_PROGRESS (đang xử lý)
FAILURE (thất bại)
SUCCESS (thành công) |
submitTime | number | 1689231405854 | Thời điểm gửi nhiệm vụ (timestamp) |
startTime | number | 1689231442755 | Thời điểm bắt đầu xử lý |
finishTime | number | 1689231544312 | Thời điểm hoàn tất nhiệm vụ |
failReason | string | [Invalid parameter] Invalid value | Lý do thất bại (nếu có) |
data | object | - | Dữ liệu trả về: bao gồm danh sách bài nhạc hoặc lời bài hát |
🎼 Tiếp tục nhạc#
Khi cần tiếp tục bài nhạc hiện tại, phải truyền tham số task_id để chỉ định nhiệm vụ gốc.
Modified at 2025-07-28 00:09:39
