Tạo tác vụ tạo nhạc

API gửi yêu cầu tạo nhạc, tương thích với đường dẫn /suno/submit/music cũ. Trả về ID tác vụ, sau đó truy vấn qua /suno/fetch/{task_id}.

API gửi tác vụ tạo nhạc. Đường dẫn giữ nguyên /suno/submit/music; trên thực tế có thể chọn engine tạo qua upstream_model, music_model, engine, model_id hoặc modelId. API tạo trả về task_id, sau đó dùng /suno/fetch/{task_id} để truy vấn đầu ra.

Chế độ mô tả prompt

Phù hợp khi chỉ mô tả phong cách, cảm xúc, ngôn ngữ, kiểu giọng hát và bối cảnh; mô hình sẽ tự động tạo nội dung bài hát.

{
 "model": "suno_music",
 "upstream_model": "suno-v5",
 "prompt": "Imitating "Billie Jean," create a DJ song with the theme of "the artificial intelligence revolution."",
 "make_instrumental": false
}

Nhạc nhẹ hoặc nhạc nền không lời

Có thể dùng light_music=true hoặc make_instrumental=true. light_music biểu thị thiên về nhạc nhẹ/nhạc nền, make_instrumental biểu thị không tạo giọng hát.

{
 "model": "suno_music",
 "upstream_model": "minimax-music-v2.6",
 "prompt": "Warm cafe background music with soft piano and strings, relaxing and cinematic.",
 "light_music": true,
 "make_instrumental": true
}

Chế độ nâng cao cho lời bài hát

Phù hợp khi phía nghiệp vụ đã chuẩn bị sẵn lời bài hát và cần chỉ định tiêu đề cùng thẻ phong cách. Có thể truyền custom_mode=true, trường lời bài hát có thể dùng lyrics, lyric, custom_lyrics hoặc customLyrics.

{
 "model": "suno_music",
 "upstream_model": "mureka-v9",
 "custom_mode": true,
 "title": "Summer Sea Breeze",
 "tags": "electro pop, female vocal, bright summer",
 "lyrics": "[Verse]\nSea breeze moves across the white sand\n[Chorus]\nTurn the summer into a beam of light"
}

Truy vấn

Sau khi tạo thành công, hãy lưu lại data task ID được trả về, ví dụ task_xxx, rồi gọi GET /suno/fetch/{task_id} để truy vấn trạng thái, địa chỉ âm thanh, ảnh bìa, tiêu đề, lời bài hát và thông tin đoạn dữ liệu gốc do upstream trả về.