Поддерживаемые модели
Доступные модели генерации
Запросы принимают только те названия моделей платформы, которые перечислены ниже. Другие имена, включая похожие на существующие модели, не принимаются.
| Название модели | Отображаемое имя | Назначение | Статус |
|---|---|---|---|
suno-v6 |
Suno V6 | Модель генерации по умолчанию | Доступна |
suno-v6-wild |
Suno V6 Wild | Вариант Wild для V6 | Доступна |
suno-v6-mini |
Suno V6 Mini | Вариант Mini для V6 | Доступна |
Рекомендуемая модель по умолчанию: suno-v6.
О разделении на стемы
Разделение на стемы — отдельная фиксированная функция: выбирать модель генерации не нужно.
Достаточно передать исходную композицию и режим разделения (например two или twelve).
Число полученных дорожек указано в ответе.
Параметр model
В эндпоинтах генерации model обычно необязателен:
- Не указан: используется значение по умолчанию
suno-v6. - Указан: должен быть
suno-v6,suno-v6-wildилиsuno-v6-mini. - Принимаются только названия моделей из таблицы выше.
Минимальный пример генерации
curl -X POST https://www.suno-api.io/api/music/create \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"description": "весёлая фолк-песня о первом дне весны",
"model": "suno-v6"
}'
Пример с вариантом V6
{
"model": "suno-v6-wild",
"description": "электронная композиция с экспериментальной структурой"
}
Отключённые модели
Эти модели больше не принимают новые запросы:
suno-v2suno-v3suno-v3-5suno-v4suno-v4-5suno-v4-5-allsuno-v4-5-plussuno-v5suno-v5-5
Старые композиции и задачи могут по-прежнему показывать прежние model_name или
model_version. Это исторические данные: они не означают, что старая модель принимает новые
запросы.
Для совместимости с существующими клиентами запрос с отключённой моделью обрабатывается на
текущей модели по умолчанию suno-v6, а не отклоняется. Задача также записывает suno-v6, и
ошибка «модель недоступна» не возвращается. Тем не менее обновите примеры на актуальные
названия как можно скорее.
Список моделей
GET /v1/models должен включать как минимум эти музыкальные модели:
{
"object": "list",
"data": [
{ "id": "suno-v6", "object": "model", "owned_by": "suno" },
{ "id": "suno-v6-wild", "object": "model", "owned_by": "suno" },
{ "id": "suno-v6-mini", "object": "model", "owned_by": "suno" }
]
}
В ответе также могут быть модели для текстов, маршруты совместимости или внутренние модели. Не путайте их с моделями V6 для генерации музыки.
Как выбрать вариант V6
В большинстве интеграций достаточно модели по умолчанию. Три варианта различаются точностью следования промпту и разнообразием результата.
| Вариант | Когда использовать |
|---|---|
suno-v6 |
Когда нужен предсказуемый результат, близкий к описанию. Это значение по умолчанию и правильный выбор для продакшена. |
suno-v6-wild |
Когда нужно больше вариаций и можно сравнить несколько дублей. Полезно для поиска стиля. |
suno-v6-mini |
Когда нужно проверить промпт с минимальными затратами перед реальной генерацией. |
Поскольку каждый запуск возвращает две композиции, удобная схема — набросать вариант на
suno-v6-mini, а затем прогнать одобренный промпт на suno-v6 и выбрать версию для
публикации.
Стоимость и возвраты
Оплата берётся за запрос, а не за модель: каждый запуск стоит 0,6 ¥ и возвращает две композиции. Неудачные генерации возвращаются автоматически, поэтому неудачная попытка не тратит баланс. Скачивание не ограничено и никогда не тарифицируется отдельно.
Получить API-ключ
Создайте API-ключ в консоли после регистрации. Одна генерация стоит 0,6 ¥ и возвращает 2 трека, загрузки не ограничены, номер телефона не нужен.
Получить API-ключ Вернуться к обзору