Skip to content

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ườngKiểuVí dụMô tả
task_idstringf4a94d75-087b-4bb1-bd45-53ba293faf96ID tác vụ
actionstringMUSICLoại tác vụ: MUSIC (tạo bài hát), LYRICS (tạo lời)
statusstringSUCCESSTrạ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)
submitTimenumber1689231405854Thời gian gửi
startTimenumber1689231442755Thời gian bắt đầu
finishTimenumber1689231544312Thời gian kết thúc
failReasonstring[Invalid parameter] Invalid valueLý do thất bại (khi thất bại)
dataobject-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ụ