Введение
Suno v6 в SpicyAPI — это задача text-to-music, которая за один запрос возвращает две готовые версии песни, каждая из которых — полноценный MP3 с вокалом и аккомпанементом. Вы описываете стиль в prompt и, если они у вас есть, передаёте слова для пения в lyrics. Suno называет v6 своей надёжной и точной моделью, и в наших тестах она спела текст слово в слово, по порядку. Одна фиксированная цена покрывает весь запрос.
Ключевые возможности и особенности
Два дубля каждый раз
Каждый запрос возвращает две полные версии песни. Это не фрагменты одна другой: они могут отличаться и аранжировкой, и длиной, так что можно оставить ту, что нравится. Фиксированная цена покрывает обе.
Ваш текст — спетый как написано
Текст из 11 строк вернулся спетым строка за строкой в том порядке, в каком мы его написали. Теги секций вроде [Verse] и [Chorus] задавали структуру, не звуча в песне, а припев не повторялся, пока его не повторял сам текст.
Три способа работы со словами
Приносите свой текст, поручите его модели по prompt (generate_lyrics включён по умолчанию) или включите instrumental, чтобы обойтись без вокала. Тонкие настройки вроде title, vocal_gender, style_weight, weirdness, variety и персон работают, когда вы приносите свой текст или выбираете инструментал.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
prompt | Да | Описание стиля. Со своим текстом или при включённом instrumental это только стиль: жанр, темп, инструменты, голос, настроение, до 1 000 символов. Не менее 1 символов · Не более 3000 символов |
lyrics | Нет | Слова для пения, до 5 000 символов, по одной строке на строку. Теги секций вроде [Verse], [Chorus], [Bridge] и [Outro] на отдельных строках задают структуру и не поются. Не менее 1 символов · Не более 5000 символов |
generate_lyrics | Нет | По умолчанию включено: если lyrics пусто, а instrumental выключен, модель пишет слова по prompt. Ваш собственный текст никогда не переписывается. По умолчанию: |
instrumental | Нет | Включите, чтобы получить трек без вокала. Тогда prompt описывает стиль (до 1 000 символов), а lyrics не нужен. По умолчанию: |
title | Нет | Название песни, до 80 символов. Действует со своим текстом или при включённом instrumental; при сгенерированных словах название выбирает модель. Не менее 1 символов · Не более 80 символов |
negative_prompt | Нет | Стили, звуки или настроения, которые нужно исключить из песни, коротким списком через запятую, например «harsh distortion, spoken word». Необязательно. Не менее 1 символов · Не более 500 символов |
vocal_gender | Нет | Склоняет ведущий вокал к женскому (female) или мужскому (male). Это пожелание, а не гарантия, и как часто оно выполняется, мы не проверяли. |
style_weight | Нет | Насколько строго песня следует описанию стиля: от 0 до 1 с шагом 0,01. |
weirdness | Нет | Насколько далеко песня может уйти от ожидаемого: от 0 (традиционно) до 1 (смело), с шагом 0,01. Действует только со своим текстом или при включённом instrumental. |
audio_weight | Нет | Насколько сильно входное аудио влияет на результат: от 0 до 1 с шагом 0,01. Для песен без вокала Suno это не поддерживает. |
variety | Нет | Насколько модель варьирует ваш промпт стиля: целое число от 0 (выключено: теги стиля используются ровно как написаны) до 4 (максимум). По умолчанию 1. |
persona_id | Нет | ID сохранённой персоны или голоса Suno, который исполнит песню. Необязательно. Не менее 1 символов · Не более 200 символов |
persona_model | Нет | Сообщает модели, чем является |
image_urls | Нет | До 5 картинок-настроений (JPEG, PNG, WebP или BMP, каждая до 10 МБ), по которым модель улавливает характер песни. Не более 5 элементов |
reference_video_urls | Нет | Одно референсное видео (MP4, MOV или WebM, до 100 МБ и 241 секунды), вокруг которого строится песня, например чтобы озвучить его музыкой. Не более 1 элементов |
reference_audio_urls | Нет | Один референсный аудиофайл (от 6 секунд до 30 минут, до 500 МБ), который вдохновляет песню. Не более 1 элементов |
Стоимость
$0.072 / запрос
Фиксированная цена за запрос, включает обе версии песни независимо от их длины.
Сценарии использования
Песни, которые вы уже написали
Стихи, тосты, джинглы и песни-истории: оставьте текст как есть, выберите жанр и голос и сравните две версии. Песни шли примерно от полутора минут для короткого текста до двух с лишним минут для полного.
Музыка под картинку или ролик
Со сгенерированными словами можно передать до 5 картинок-настроений, одно референсное видео или одно референсное аудио, и модель напишет песню вокруг них. Для фона без слов включите instrumental.
Руководство по промптам и практические советы
Описывайте звучание, а не исполнителя
Укажите жанр, темп в bpm, два-три инструмента и тип голоса: «soft neo-soul ballad, 78 bpm, warm female lead vocal, Rhodes piano». Промпты с именами реальных исполнителей отклоняются, поэтому описывайте звучание.
Размечайте секции тегами
Ставьте [Intro], [Verse], [Chorus], [Bridge] и [Outro] на отдельные строки и повторяйте текст припева там, где он должен вернуться. Чем больше строк, тем длиннее песня; настройки длительности нет.
Знайте, что останавливает фильтр
Suno отклоняет самые сильные тексты и описания в течение секунд и не списывает за них. Более мягкие тексты и грубая лексика поются, так что держите написанное по эту сторону черты.
Быстрый старт API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "suno/v6/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Аутентификация, полная схема, опрос статуса и обработка ошибок описаны в справочнике API.
