Obsługiwane modele
Dostępne modele generacji
Żądania przyjmują wyłącznie nazwy modeli platformy wymienione poniżej. Inne nazwy, w tym podobne do istniejących modeli, nie są akceptowane.
| Nazwa modelu | Nazwa wyświetlana | Zastosowanie | Status |
|---|---|---|---|
suno-v6 |
Suno V6 | Domyślny model generacji | Dostępny |
suno-v6-wild |
Suno V6 Wild | Wariant Wild dla V6 | Dostępny |
suno-v6-mini |
Suno V6 Mini | Wariant Mini dla V6 | Dostępny |
Zalecany model domyślny: suno-v6.
O rozdzielaniu ścieżek
Rozdzielanie na stemy to osobna, stała funkcja: nie trzeba wybierać modelu generacji. Wystarczy
przekazać oryginalny utwór i tryb rozdzielania (na przykład two lub twelve). Liczba
zwróconych ścieżek jest podana w odpowiedzi.
Parametr model
W endpointach generacji model jest zwykle opcjonalny:
- Pominięty: używana jest wartość domyślna
suno-v6. - Podany: musi to być
suno-v6,suno-v6-wildlubsuno-v6-mini. - Akceptowane są tylko nazwy modeli z tabeli powyżej.
Minimalny przykład generacji
curl -X POST https://www.suno-api.io/api/music/create \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"description": "wesoła piosenka folkowa o pierwszym dniu wiosny",
"model": "suno-v6"
}'
Przykład z wariantem V6
{
"model": "suno-v6-wild",
"description": "utwór elektroniczny o eksperymentalnej strukturze"
}
Modele wyłączone
Te modele nie przyjmują już nowych żądań:
suno-v2suno-v3suno-v3-5suno-v4suno-v4-5suno-v4-5-allsuno-v4-5-plussuno-v5suno-v5-5
Starsze utwory i zadania mogą nadal pokazywać dawny model_name lub model_version. To dane
historyczne: nie oznaczają, że stary model przyjmuje nowe żądania.
Dla zgodności z istniejącymi klientami żądanie z wyłączonym modelem jest realizowane na
obecnym modelu domyślnym suno-v6, a nie odrzucane. Zadanie również zapisuje suno-v6 i nie
jest zwracany błąd „model niedostępny”. Mimo to jak najszybciej zaktualizuj przykłady do
aktualnych nazw.
Lista modeli
GET /v1/models powinien zawierać co najmniej te modele muzyczne:
{
"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" }
]
}
Odpowiedź może też zawierać modele tekstowe, trasy zgodności lub modele wewnętrzne. Nie myl ich z modelami V6 do generowania muzyki.
Jak wybrać wariant V6
W większości integracji model domyślny wystarcza. Trzy warianty różnią się wiernością promptowi i zróżnicowaniem wyniku.
| Wariant | Kiedy używać |
|---|---|
suno-v6 |
Gdy chcesz przewidywalny wynik zgodny z opisem. To wartość domyślna i właściwy wybór do produkcji. |
suno-v6-wild |
Gdy chcesz więcej zróżnicowania i możesz porównać kilka podejść. Przydatne przy szukaniu stylu. |
suno-v6-mini |
Gdy chcesz przetestować prompt najniższym kosztem przed prawdziwą generacją. |
Ponieważ każde uruchomienie zwraca dwa utwory, praktyczny schemat to szkic na suno-v6-mini, a
następnie uruchomienie zaakceptowanego promptu na suno-v6 i wybór wersji do publikacji.
Koszt i zwroty
Opłata jest za żądanie, nie za model: każde uruchomienie kosztuje 0,6 ¥ i zwraca dwa utwory. Nieudane generacje są zwracane automatycznie, więc nieudana próba nie zużywa salda. Pobieranie jest nieograniczone i nigdy nie jest rozliczane osobno.
Uzyskaj klucz API
Po rejestracji utwórz klucz API w konsoli. Każde generowanie kosztuje 0,6 ¥ i zwraca 2 utwory, pobierania są nieograniczone, a numer telefonu nie jest wymagany.
Pobierz klucz API Powrót do przeglądu