Tổng quan

Tài liệu API Suno

Thông tin cơ bản

Điểm cuối API

• Mặc định:

  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 (phiên bản v3.0)
• chirp-v3-5 (phiên bản v3.5)
• chirp-v4 (phiên bản v4.0)
• chirp-auk (phiên bản v4.5)
• chirp-v5 (phiên bản v5.0)

Thông báo gọi lại

• Hỗ trợ URL gọi lại notify_hook
• Yêu cầu:
  • Phương thức: 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)
status	string	SUCCESS	Trạng thái: NOT_START (chưa bắt đầu), SUBMITTED (đã gửi), QUEUED (xếp hàng), IN_PROGRESS (đang chạy), 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
finishTime	number	1689231544312	Thời gian kết thúc
failReason	string	[Invalid parameter] Invalid value	Lý do thất bại (khi thất bại)
data	object	-	Dữ liệu: nhạc (mảng) hoặc lời (đối tượng đơn)

Tiếp tục nhạc

• Cần truyền tham số task_id để chỉ định tác vụ