ToAPIsToAPIs
Suno

Генерация музыки

Генерация музыки Suno — режим вдохновения и кастомного текста, тариф Max

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

Authorizations

Authorizationstringзаголовокобязательно

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-mini
max_modebooleanтело
Max-тариф(×2, $0.10). Требуется custom=true
persona_idstringтело
ID вокальной персоны. Взаимоисключается с custom_model_id
custom_model_idstringтело
ID кастомной модели. Взаимоисключается с version и persona_id

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

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

Response

task_idstring

ID задачи(префикс tsk_aud_); опрос через статус задачи

statusstring
submitted / 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());