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

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

Интерфейс отправки задания на генерацию музыки и звука. Путь остается /suno/submit/music; фактически можно выбрать движок генерации через upstream_model, music_model, engine, model_id или modelId. Интерфейс создания возвращает 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-v5.5",
  "prompt": "Create an energetic retro-pop DJ song about the artificial intelligence revolution.",
  "make_instrumental": false
}

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

MiniMax Speech может переопределять параметры голоса через extraParams (или одноименные поля верхней области видимости в формате snake_case/camelCase).

{
  "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 (или lyria-3-pro-preview):

{
  "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, lyric, custom_lyrics или 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"
}

Запрос

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