Skip to main content
POST
  • Генерация полного трека по описанию или кастомному тексту(2 варианта за запрос)
  • Асинхронная задача, опрос по ID
  • custom определяет смысл prompt: кастомный текст vs описание

Authorizations

string
обязательно

Body

string
обязательно
Фиксированное "suno"
boolean
Переключатель режима, по умолчанию false
  • false: режим вдохновения — gpt_description(или prompt) описывает музыку
  • true: кастомный текст — prompt это слова; работают title/style/negative_tags
string
Описание музыки в режиме вдохновения, например "lo-fi для дождливого кафе". В кастомном режиме не нужно
string
Текст песни в кастомном режиме(поддержка тегов [Verse]/[Chorus])
string
Название(кастомный режим)
string
Теги стиля, например "dreamy synthwave, female vocal"
string
Чего избегать(кастомный режим)
boolean
Только инструментал
string
Версия движка:v6 / v6-wild / v6-mini
boolean
Max-тариф(×2, $0.10). Требуется custom=true
string
ID вокальной персоны. Взаимоисключается с custom_model_id
string
ID кастомной модели. Взаимоисключается с version и persona_id

Опциональные параметры тюнинга

style_weight, weirdness, audio_weight, vocal_gender, auto_lyrics, variety — опциональны, при пропуске применяются значения upstream.

Response

string
ID задачи(префикс tsk_aud_); опрос через статус задачи
string
submitted / queued / in_progress
По завершении result.music[] возвращает 2 варианта с audio_url, image_url, title, tags, lyrics, duration. Медиа зеркалируется на CDN.