Suno
Генерация музыки
Генерация музыки Suno — режим вдохновения и кастомного текста, тариф Max
- Генерация полного трека по описанию или кастомному тексту(2 варианта за запрос)
- Асинхронная задача, опрос по ID
customопределяет смыслprompt: кастомный текст vs описание
Authorizations
AuthorizationstringзаголовокобязательноBearer Token. API Key:страница управления
Body
modelstringтелообязательноФиксированное
"suno"custombooleanтелоПереключатель режима, по умолчанию false
false: режим вдохновения —gpt_description(илиprompt) описывает музыкуtrue: кастомный текст —promptэто слова; работаютtitle/style/negative_tags
gpt_descriptionstringтелоОписание музыки в режиме вдохновения, например "lo-fi для дождливого кафе". В кастомном режиме не нужно
promptstringтелоТекст песни в кастомном режиме(поддержка тегов [Verse]/[Chorus])
titlestringтелоНазвание(кастомный режим)
stylestringтелоТеги стиля, например
"dreamy synthwave, female vocal"negative_tagsstringтелоЧего избегать(кастомный режим)
instrumentalbooleanтелоТолько инструментал
versionstringтелоВерсия движка:
v6 / v6-wild / v6-minimax_modebooleanтелоMax-тариф(×2, $0.10). Требуется
custom=truepersona_idstringтелоID вокальной персоны. Взаимоисключается с
custom_model_idcustom_model_idstringтелоID кастомной модели. Взаимоисключается с
version и persona_idОпциональные параметры тюнинга
style_weight, weirdness, audio_weight, vocal_gender, auto_lyrics, variety — опциональны, при пропуске применяются значения upstream.
Response
task_idstringID задачи(префикс tsk_aud_); опрос через статус задачи
statusstringsubmitted / queued / in_progressПо завершении result.music[] возвращает 2 варианта с audio_url, image_url, title, tags, lyrics, duration. Медиа зеркалируется на CDN.
Пример запроса
curl --request POST \
--url https://toapis.com/v1/music/generations/generation \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"model": "suno",
"gpt_description": "lo-fi jazz for a rainy café",
"instrumental": false,
"version": "v6"
}'import requests
resp = requests.post(
"https://toapis.com/v1/music/generations/generation",
headers={"Authorization": "Bearer <token>"},
json={
"model": "suno",
"custom": True,
"prompt": "[Verse]\nNeon lights are glowing\n[Chorus]\nWe ride until the morning",
"title": "Neon Ride",
"style": "synthwave",
"max_mode": True
}
)
print(resp.json())const resp = await fetch("https://toapis.com/v1/music/generations/generation", {
method: "POST",
headers: {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
},
body: JSON.stringify({
model: "suno",
gpt_description: "dreamy synthwave with female vocals",
version: "v6-wild"
})
});
console.log(await resp.json());