Gebruik Suno Sounds via Rivya Public API v1 met model-id suno-sounds, ondersteunde inputs, parameters, Files API-regels, credits en responsevoorbeelden.

Beschikbaar via APITekstinput gereedAudio

API-model-id

suno-sounds

Inputs

text

Files API

Niet vereist voor de minimale request

Basiscredits

Mogelijkheid

Audio

Facturering

FIXED

Promptlimiet

500 tekens

Requestcontract

Stuur de model-id op topniveau. Modelspecifieke controles horen in params.

Key	Type	Vereist	Standaard	Beschrijving
model	string	Ja	suno-sounds	Gebruik de API-model-id suno-sounds.
prompt	string	Ja	-	Maximaal 500 tekens voor dit model.
params	object	Nee	-	Modelspecifiek parameterobject. Gebruik de rijen hieronder voor toegestane keys.
client_request_id	string	Nee	-	Optionele client-side id voor requesttracing in je systeem.

Modelparameters

Key	Type	Vereist	Standaard	Bereik	Opties	Beschrijving
model	select	Nee	V5	-	V5, V5_5	Selecteert welke Suno-generatiefamilie wordt gebruikt. Nieuwere versies verwerken stijl en detail vaak beter, maar kunnen verschillen in kosten en gedrag.
soundLoop	select	Nee	false	-	false, true	Loopweergave
soundTempo	number	Nee	-	min 1 / max 300 / step 1	-	Stelt het tempo in beats per minute in. Hogere waarden voelen meestal sneller en zijn nuttiger voor ritmisch sounddesign.
soundKey	select	Nee	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	Stelt de muzikale toonsoort in. Geef dit alleen op wanneer het resultaat moet passen bij bestaande harmonie of melodie; anders is breed laten meestal veiliger.

Minimale request

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

Create-response

Het create-endpoint geeft een publieke taak-id terug. Poll het statusendpoint totdat de taak slaagt of mislukt.

{
  "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
}

Veelvoorkomende fouten

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found