Używaj Suno Sounds przez Rivya Public API v1 z identyfikatorem modelu suno-sounds, obsługiwanymi wejściami, parametrami, regułami Files API, kredytami i przykładami odpowiedzi.

Dostępne przez APIWejście tekstowe gotoweAudio

Identyfikator modelu API

suno-sounds

Wejścia

text

Files API

Niewymagane dla żądania minimalnego

Kredyty bazowe

Możliwość

Audio

Rozliczenia

FIXED

Limit promptu

500 znaków

Kontrakt żądania

Wyślij identyfikator modelu na najwyższym poziomie. Kontrolki specyficzne dla modelu należą do params.

Klucz	Typ	Wymagane	Domyślnie	Opis
model	string	Tak	suno-sounds	Użyj suno-sounds jako identyfikatora modelu API.
prompt	string	Tak	-	Maksymalnie 500 znaków dla tego modelu.
params	object	Nie	-	Obiekt parametrów specyficznych dla modelu. Dozwolone klucze znajdziesz w wierszach poniżej.
client_request_id	string	Nie	-	Opcjonalny identyfikator po stronie klienta do śledzenia żądań w Twoim systemie.

Parametry modelu

Klucz	Typ	Wymagane	Domyślnie	Zakres	Opcje	Opis
model	select	Nie	V5	-	V5, V5_5	Wybiera rodzinę generowania Suno. Nowsze wersje często lepiej radzą sobie ze stylem i detalem, ale mogą różnić się kosztem oraz zachowaniem.
soundLoop	select	Nie	false	-	false, true	Odtwarzanie w pętli
soundTempo	number	Nie	-	min 1 / max 300 / step 1	-	Ustawia tempo w uderzeniach na minutę. Wyższe wartości zwykle brzmią szybciej i są bardziej przydatne w rytmicznym projektowaniu dźwięku.
soundKey	select	Nie	Any	-	Any, Cm, C#m, Dm, D#m, Em, Fm, F#m, Gm, G#m, Am, A#m, Bm, C, C#, D, D#, E, F, F#, G, G#, A, A#, B	Ustawia tonację muzyczną. Podaj ją tylko wtedy, gdy wynik musi pasować do istniejącej harmonii albo melodii; w przeciwnym razie szersze ustawienie jest zwykle bezpieczniejsze.

Żądanie minimalne

{
  "model": "suno-sounds",
  "prompt": "A polished audio concept for a short product story",
  "params": {
    "model": "V5",
    "soundLoop": "false",
    "soundTempo": 1,
    "soundKey": "Any"
  }
}

Odpowiedź tworzenia

Endpoint tworzenia zwraca publiczny identyfikator zadania. Odpytuj endpoint statusu, aż zadanie zakończy się sukcesem albo błędem.

{
  "id": "task_suno_sounds_example",
  "status": "queued",
  "model": "suno-sounds",
  "reserved_credits": 3,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

Typowe błędy

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found