Підтримувані моделі
Доступні моделі генерації
Запити приймають лише ті назви моделей платформи, які наведені нижче. Інші назви, зокрема схожі на наявні моделі, не приймаються.
| Назва моделі | Відображувана назва | Призначення | Статус |
|---|---|---|---|
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-ключ Повернутися до огляду