Создать задачу генерации музыки или звука

Интерфейс отправки задания на генерацию музыки и звука, совместимый со старым путем /suno/submit/music. Возвращает ID задачи; затем запрос можно проверить через /suno/fetch/{task_id}.

Интерфейс отправки задач на генерацию музыки и звука. Передавайте имя подмодели через upstream_model. Интерфейс создания возвращает task_id, затем используйте /suno/fetch/{task_id} для запроса результата.

Если не передан upstream_model (или передан только {"model":"suno_music"}), по умолчанию используется Suno v5.5. Если нужно продолжать использовать старую версию Suno, явно передайте "upstream_model":"suno-v5".

Доступные подмодели

Режим описания промпта

Подходит, если нужно описать только стиль, настроение, язык, тип исполнителя и сцену, а модель автоматически сгенерирует содержимое песни.

{
  "model": "suno_music",
  "upstream_model": "suno-v6",
  "prompt": "Create an energetic retro-pop DJ song about the artificial intelligence revolution.",
  "make_instrumental": false
}

Генерация звука

В MiniMax Speech можно настроить параметры голоса через extraParams.

{
  "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
  }
}

Если для MiniMax Speech не переданы параметры голоса, сервер по умолчанию отправляет voice, outputFormat=mp3, sampleRate=32000, speed=1, volume=1 и pitch=0 из примера выше.

Lyria 3 Pro использует upstream_model=lyria-3-pro:

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

Легкая музыка или чистый аккомпанемент

Можно использовать light_music=true или make_instrumental=true. light_music означает уклон в легкую/фоновую музыку, а make_instrumental — не генерировать вокал.

{
  "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
}

Расширенный режим текста песни

Подходит для случаев, когда на стороне бизнеса уже подготовлены тексты песен и нужно указать название и теги стиля. Передайте custom_mode=true и используйте lyrics для отправки текста песни.

{
  "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"
}

Запрос

После успешного создания сохраните возвращенный data ID задачи, например task_xxx, и вызовите GET /suno/fetch/{task_id}, чтобы получить статус, URL аудио, обложку, заголовок, текст песни и исходные фрагменты, возвращенные upstream.