Tài liệu API Suno#
Thông tin cơ bản#
Địa chỉ API#
https://{BASE_URL}/suno/submit/music
https://{BASE_URL}/suno/fetch
Hỗ trợ mô hình#
Các mô hình được hỗ trợ#
chirp-v3-0 (tương ứng phiên bản v3.0)
chirp-v3-5 (tương ứng phiên bản v3.5)
chirp-v4 (tương ứng phiên bản v4.0)
chirp-auk (tương ứng phiên bản v4.5)
chirp-v5 (tương ứng phiên bản v5.0)
Thông báo callback#
Hỗ trợ địa chỉ callback notify_hook
Phương thức yêu cầu: POST
Dữ liệu nhận: cấu trúc dữ liệu task
Các bước sử dụng#
1. Tạo tác vụ Suno#
2. Truy vấn tiến độ tác vụ#
Cấu trúc dữ liệu#
Đối tượng Task#
| Trường | Kiểu | Ví dụ | Mô tả |
|---|
| task_id | string | f4a94d75-087b-4bb1-bd45-53ba293faf96 | ID tác vụ |
| action | string | MUSIC | Loại tác vụ: MUSIC (tạo bài hát), LYRICS (tạo lời bài hát) |
| status | string | SUCCESS | Trạng thái tác vụ: NOT_START (chưa bắt đầu), SUBMITTED (đã gửi xử lý), QUEUED (đang chờ), IN_PROGRESS (đang thực hiện), FAILURE (thất bại), SUCCESS (thành công) |
| submitTime | number | 1689231405854 | Thời gian gửi |
| startTime | number | 1689231442755 | Thời gian bắt đầu thực hiện |
| finishTime | number | 1689231544312 | Thời gian kết thúc |
| failReason | string | [Invalid parameter] Invalid value | Lý do thất bại (có giá trị khi thất bại) |
| data | object | - | Dữ liệu cụ thể: nhạc (mảng), lời bài hát (đơn lẻ) |
Tiếp tục viết nhạc#
Cần truyền tham số task_id để chỉ định tác vụ
Modified at 2026-03-10 12:46:27