Tạo tác vụ tạo nhạc hoặc âm thanh

API gửi yêu cầu tạo nhạc và âm thanh, tương thích với đường dẫn cũ /suno/submit/music. 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 và âm thanh. Đường dẫn giữ nguyên /suno/submit/music, 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.

Khi không truyền upstream_model (hoặc chỉ truyền {"model":"suno_music"}), mặc định dùng Suno v5.5. Nếu cần tiếp tục dùng phiên bản Suno cũ, vui lòng truyền rõ "upstream_model":"suno-v5".

Mô hình mới

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.5",
  "prompt": "Create an energetic retro-pop DJ song about the artificial intelligence revolution.",
  "make_instrumental": false
}

Tạo âm thanh

MiniMax Speech có thể ghi đè các tham số giọng nói thông qua extraParams (hoặc trường trùng tên dạng snake_case/camelCase ở cấp cao nhất).

{
  "model": "suno_music",
  "upstream_model": "minimax-speech-2.8-hd",
  "prompt": "欢迎使用新版语音生成服务。",
  "extraParams": {
    "voice": "moss_audio_ce44fc67-7ce3-11f0-8de5-96e35d26fb85",
    "outputFormat": "mp3",
    "sampleRate": 32000,
    "speed": 1,
    "volume": 1,
    "pitch": 0
  }
}

Khi MiniMax Speech không truyền tham số giọng nói, máy chủ mặc định gửi các giá trị voice, outputFormat=mp3, sampleRate=32000, speed=1, volume=1 và pitch=0 như trong ví dụ trên.

Lyria 3 Pro sử dụng upstream_model=lyria-3-pro (hoặc lyria-3-pro-preview):

{
  "model": "suno_music",
  "upstream_model": "lyria-3-pro",
  "prompt": "Cinematic orchestral music with a hopeful finale."
}

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ề.