Folosește Suno Sounds prin Rivya Public API v1 cu ID-ul modelului suno-sounds, intrările acceptate, parametrii, regulile Files API, creditele și exemplele de răspuns.

Disponibil prin APIIntrare text pregătităAudio

ID model API

suno-sounds

Intrări

text

Files API

Nu este necesar pentru cererea minimă

Credite de bază

per_request · generate_sounds=2.5 · separate_vocal=10 · ⌈total⌉

Capabilitate

Audio

Facturare

FIXED

Limită prompt

500 caractere

Contract cerere

Trimite ID-ul modelului la nivelul superior. Opțiunile specifice modelului trebuie incluse în `params`.

Cheie	Tip	Necesar	Implicit	Descriere
model	string	Da	suno-sounds	Folosește ID-ul de model API suno-sounds.
prompt	string	Da	-	Maximum 500 caractere pentru acest model.
params	object	Nu	-	Obiectul `params` conține parametrii specifici modelului. Folosește rândurile de mai jos pentru cheile permise.
client_request_id	string	Nu	-	ID opțional din partea clientului pentru urmărirea cererilor în sistemul tău.

Parametri model

Cheie	Tip	Necesar	Implicit	Interval	Opțiuni	Descriere
model	select	Nu	V5	-	V5, V5_5	Selectează familia de generare Suno care va fi folosită. Versiunile mai noi gestionează adesea mai bine stilul și detaliile, dar pot diferi ca preț și comportament.
soundLoop	select	Nu	false	-	false, true	Redare în buclă
soundTempo	number	Nu	-	min 1 / max 300 / step 1	-	Setează tempo-ul în bătăi pe minut. Valorile mai mari se simt de obicei mai rapide și sunt mai utile pentru sound design ritmic.
soundKey	select	Nu	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	Setează tonalitatea muzicală. Specific-o doar când rezultatul trebuie să se potrivească unei armonii sau melodii existente; altfel, de obicei este mai sigur să o lași largă.

Cerere minimă

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

Răspuns la creare

Endpointul de creare returnează un ID public al sarcinii. Interoghează endpointul de stare până când sarcina reușește sau eșuează.

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

Erori comune

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found