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#
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)
chirp-fenix (tương ứng phiên bản v5.5)
Thông báo callback#
Hỗ trợ địa chỉ callback notify_hook
Phương thức request: POST
Dữ liệu nhận: cấu trúc dữ liệu task
Các bước sử dụng#
1. Tạo nhiệm vụ Suno#
2. Truy vấn tiến độ nhiệm 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 nhiệm vụ |
| action | string | MUSIC | Loại nhiệm vụ: MUSIC(tạo bài hát), 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 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 thi |
| 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 nhạc#
Cần truyền tham số task_id để chỉ định nhiệm vụ
Modified at 2026-05-16 14:24:59