Wprowadzenie
Suno v6 Mini w SpicyAPI to zadanie text-to-music, które zwraca dwie gotowe wersje utworu na żądanie. Suno opisuje go jako szybszą, wydajniejszą wersję v6, która ułatwia zamianę pomysłu w piosenkę. W prompt wysyłasz opis stylu, opcjonalnie własny tekst w lyrics, a w odpowiedzi dostajesz dwa pliki MP3. Kosztuje tu tyle samo co v6 i v6 Wild, czyli jedną stałą cenę.
Najważniejsze funkcje
Pomysł na wejściu, piosenka na wyjściu
Napisz jedno zdanie i zostaw lyrics puste: przy włączonym generate_lyrics (domyślnie) model napisze słowa i je zaśpiewa. W naszym teście napisał około trzech i pół minuty tekstu i zaśpiewał każdą linijkę po kolei.
Taka sama obsługa tekstu
Przynieś własne słowa, a v6 Mini zaśpiewa je tak, jak zostały napisane. Tekst z 11 linijek, którego użyliśmy we wszystkich trzech modelach, wrócił słowo w słowo i po kolei, a znaczniki [Verse] i [Chorus] pozostały niemymi.
Para ujęć
Każde żądanie zwraca dwie wersje, które mogą różnić się długością. Jedna stała cena obejmuje obie, więc szybki szkic kosztuje tyle samo, bez względu na to, jak długi wyjdzie utwór.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
prompt | Tak | Opis stylu. Przy własnym tekście lub włączonym instrumental to wyłącznie styl: gatunek, tempo, instrumenty, głos, nastrój, do 1000 znaków. od 1 znaków · do 3000 znaków |
lyrics | Nie | Słowa do zaśpiewania, do 5000 znaków, jedna linijka w wierszu. od 1 znaków · do 5000 znaków |
generate_lyrics | Nie | Domyślnie włączone: gdy lyrics jest puste, a instrumental wyłączone, model pisze tekst na podstawie prompt. Tekst, który podasz, nigdy nie jest przepisywany. Domyślnie: |
instrumental | Nie | Włącz, aby uzyskać utwór bez wokalu. Wtedy prompt opisuje styl (do 1000 znaków), a lyrics nie jest potrzebne. Domyślnie: |
title | Nie | Tytuł utworu, do 80 znaków. Działa przy własnym tekście lub przy włączonym instrumental; przy wygenerowanym tekście tytuł wybiera model. od 1 znaków · do 80 znaków |
negative_prompt | Nie | Style, dźwięki lub nastroje, które mają zostać poza utworem, jako krótka lista oddzielona przecinkami, na przykład „harsh distortion, spoken word”. Opcjonalne. od 1 znaków · do 500 znaków |
vocal_gender | Nie | Przechyla głos prowadzący w stronę żeńskiego lub męskiego. To preferencja, a nie gwarancja, i nie testowaliśmy, jak często jest spełniana. |
style_weight | Nie | Jak ściśle utwór trzyma się opisu stylu, od 0 do 1 w krokach co 0,01. Działa tylko przy własnym tekście lub włączonym instrumental; w innych przypadkach zwraca czytelny błąd. |
weirdness | Nie | Jak daleko utwór może odejść od tego, czego się spodziewasz, od 0 (konwencjonalnie) do 1 (odważnie), w krokach co 0,01. |
audio_weight | Nie | Jak mocno dźwięk wejściowy wpływa na wynik, od 0 do 1 w krokach co 0,01. Suno nie obsługuje tego w utworach bez wokalu. |
variety | Nie | Jak bardzo model modyfikuje Twój prompt stylu, jako liczba całkowita od 0 (wyłączone: Twoje znaczniki stylu są używane dokładnie tak, jak je zapisałeś) do 4 (maksimum). |
persona_id | Nie | Identyfikator zapisanej persony lub głosu Suno, które zaśpiewają albo zagrają utwór. Opcjonalne. od 1 znaków · do 200 znaków |
persona_model | Nie | Mówi modelowi, czym jest |
image_urls | Nie | Do 5 obrazów nastroju (JPEG, PNG, WebP lub BMP, każdy do 10 MB), na których model opiera klimat utworu. do 5 elementów |
reference_video_urls | Nie | Jedno wideo referencyjne (MP4, MOV lub WebM, do 100 MB i 241 sekund), wokół którego powstaje utwór, na przykład aby opatrzyć je muzyką. do 1 elementów |
reference_audio_urls | Nie | Jeden plik audio referencyjny (od 6 sekund do 30 minut, do 500 MB), który inspiruje utwór. do 1 elementów |
Cennik
$0.072 / żądanie
Jedna stała cena za żądanie, obejmująca obie wersje utworu, niezależnie od ich długości.
Zastosowania
Szybkie szkicowanie piosenek
Traktuj go jak notes: wpisz refren, posłuchaj, przepisz. Krótkie teksty dają utwory trwające około półtorej minuty.
Łagodne, akustyczne i loungeowe style
Opisy folku, indie i jazzu z kilkoma nazwanymi instrumentami to właśnie to, co generowaliśmy do naszych próbek, od folkowego utworu na gitarze granej palcami po zadymiony instrumentalny lounge.
Wskazówki
Opis ma być krótki i konkretny
Podaj gatunek, tempo w bpm i dwa lub trzy instrumenty, na przykład „acoustic indie folk, 96 bpm, warm male vocal, fingerpicked guitar”. Nazwiska prawdziwych artystów są odrzucane.
Pozwól mu pisać, a potem przejmij stery
Zacznij od pomysłu i przeczytaj tekst, który wybrał model. Skopiuj do lyrics te linijki, które Ci się podobają, zmień je i uruchom ponownie, aby usłyszeć je zaśpiewane dokładnie tak, jak je napisałeś.
Wiedz, co zatrzymuje filtr
Suno odrzuca teksty i opisy powyżej poziomu Łagodny w ciągu sekund, bez obciążenia. Teksty na poziomie Łagodny i mocny język były śpiewane.
Szybki start z 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"
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.
