Создать задачу генерации музыки
Интерфейс отправки задачи на генерацию музыки, совместимый со старым путем /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} запрашивается результат.
Режим описания промпта
Подходит, если нужно описать только стиль, настроение, язык, тип исполнителя и сцену, а модель автоматически сгенерирует содержимое песни.
{
"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
}
Легкая музыка или чистый аккомпанемент
Можно использовать 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.
Авторизации
Используйте проверку подлинности Bearer Token.
Формат: Authorization: Bearer sk-xxxxxx
Тело
Передавайте фиксированно suno_music.
suno_music "suno_music"
В режиме описания промпта — музыкальный стиль, настроение и сцена; в расширенном режиме текста песни может использоваться как совместимое поле для текста песни.
Значение выбора генераторного движка.
"suno-v5"
Совместимый псевдоним для upstream_model.
Совместимый псевдоним для upstream_model.
Поле совместимости для ID вышестоящей модели.
Совместимое поле camelCase для model_id.
Описывает поле совместимости с подсказками режима.
Генерировать только инструментальное сопровождение.
Генерировать в стиле лёгкой/фоновой музыки.
Генерировать ли в направлении чисто инструментальной музыки.
Использовать ли пользовательский режим.
Совместимое поле camelCase для custom_mode.
Название песни.
Тег стиля, например electro pop, female vocal.
Поле для совместимости стилей.
Поле совместимости жанров.
Поле совместимости жанров.
Содержимое текста песни.
lyrics Совместимый псевдоним.
lyrics Совместимый псевдоним.
lyrics Совместимый псевдоним.
