Skip to main content
Tạo nhạc và lời bài hát bằng AI. Đây là một API bất đồng bộ. Phản hồi tạo trả về danh tính tác vụ và, khi có sẵn, cũng có thể bao gồm poll_url ưu tiên.

Nội dung yêu cầu

string
mặc định:"suno_music"
Model để sử dụng: suno_music để tạo nhạc, suno_lyrics chỉ để tạo lời bài hát.
string
Mô tả âm nhạc. Bắt buộc cho yêu cầu music, lyrics, upload-cover và upload-extend; bỏ qua với add-instrumental.
string
Tiêu đề cho bài hát được tạo.
string
Các thẻ phong cách (ví dụ: “pop, upbeat, electronic”).
string
Phong cách cần tránh. Bắt buộc khi audio_operationadd-instrumental.
string
Loại tạo: MUSIC (mặc định) hoặc LYRICS.
string
Phiên bản mô hình Suno chính thức. Bắt buộc khi tạo nhạc (khi bỏ qua action hoặc dùng MUSIC); bỏ qua cho yêu cầu chỉ tạo lời bài hát. Giá trị được hỗ trợ: chirp-v3-5, chirp-v4, chirp-v4-5, chirp-v4.5, chirp-v4-5plus, chirp-v4.5plus, chirp-v4-5all, chirp-v4.5all, chirp-v5, chirp-v5-5, chirp-v5.5.
boolean
Đặt thành true để tạo đầu ra nhạc không lời, không có giọng hát.
string
URL âm thanh tham chiếu hoặc đã tải lên có thể truy cập công khai. Nếu không gửi audio_operation, TokenLab dùng luồng upload-cover.
string
Chế độ âm thanh tải lên: upload-cover, upload-extend, hoặc add-instrumental. upload-extend cần continue_at; add-instrumental cần audio_url, title, tags, và negative_tags.
string
ID của một clip trước đó để tiếp tục.
number
Mốc thời gian tính bằng giây để bắt đầu nối tiếp. Bắt buộc khi audio_operationupload-extend.

Phản hồi

string
ID tác vụ để kiểm tra trạng thái.
string
Bí danh của mã tác vụ bất đồng bộ khi được adapter trả về.
string
URL polling ưu tiên khi có sẵn.
string
Trạng thái tác vụ: pending, processing, completed, hoặc failed.
integer
Dấu thời gian Unix khi tạo tác vụ.