Введение
Suno v6 Mini в SpicyAPI — это задача text-to-music, которая за один запрос возвращает две готовые версии песни. Suno описывает её как более быструю и эффективную версию v6, которая упрощает превращение идеи в песню. Вы отправляете описание стиля в prompt, при желании свой lyrics — и получаете два MP3. Здесь она стоит ту же фиксированную цену, что и v6 с v6 Wild.
Ключевые возможности и особенности
Идея на входе, песня на выходе
Напишите одно предложение и оставьте lyrics пустым: при включённом generate_lyrics (по умолчанию) модель напишет слова и споёт их. В нашем тесте она написала слов примерно на три с половиной минуты и спела каждую строку по порядку.
Тот же подход к тексту
Принесите свои слова, и v6 Mini споёт их как написано. Текст из 11 строк, который мы использовали на всех трёх моделях, вернулся слово в слово и по порядку, а теги [Verse] и [Chorus] остались непропетыми.
Пара дублей
Каждый запрос возвращает две версии, которые могут отличаться по длине. Одна фиксированная цена покрывает обе, так что быстрый черновик стоит одинаково, какой бы длины ни получилась песня.
Параметры запроса
| Параметр | Обязательно | Описание |
|---|---|---|
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 / запрос
Фиксированная цена за запрос, включает обе версии песни независимо от их длины.
Сценарии использования
Быстрые наброски песен
Используйте её как блокнот: набрали хук, послушали, переписали. Короткие тексты дают песни примерно на полторы минуты.
Мягкие акустические и лаунж-стили
Для наших образцов мы генерировали фолк-, инди- и джазовые запросы с несколькими названными инструментами: от фолк-песни под перебор до дымного лаунж-инструментала.
Руководство по промптам и практические советы
Держите запрос коротким и конкретным
Назовите жанр, темп в bpm и два-три инструмента, например «acoustic indie folk, 96 bpm, warm male vocal, fingerpicked guitar». Имена реальных исполнителей отклоняются.
Пусть напишет, а затем берите управление на себя
Начните с идеи и прочитайте слова, которые выбрала модель. Скопируйте понравившиеся в lyrics, отредактируйте и запустите снова — они будут спеты именно так, как вы написали.
Знайте, что останавливает фильтр
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-mini/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.
