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

Disponibil prin APIIntrare text pregătităAudio

ID model API

suno-music

Intrări

text

Files API

Nu este necesar pentru cererea minimă

Credite de bază

per_request · default=12 · ⌈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-music	Folosește ID-ul de model API suno-music.
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	V4_5	-	V4, V4_5, V4_5PLUS, V4_5ALL, 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.
instrumental	select	Nu	false	-	false, true	Instrumental

Cerere minimă

{
  "model": "suno-music",
  "prompt": "A polished audio concept for a short product story",
  "params": {
    "model": "V4_5",
    "instrumental": "false"
  }
}

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_music_example",
  "status": "queued",
  "model": "suno-music",
  "reserved_credits": 12,
  "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