Utilisez Suno Sounds via Rivya Public API v1 avec le model id suno-sounds, les entrées prises en charge, les paramètres, les règles Files API, les crédits et des exemples de réponse.

Disponible via APIEntrée texte prêteAudio

ID de modèle API

suno-sounds

Entrées

text

Files API

Non requis pour la requête minimale

Crédits de base

Capacité

Audio

Facturation

FIXED

Limite de prompt

500 caractères

Contrat de requête

Envoyez l'ID du modèle au niveau supérieur. Les contrôles propres au modèle vont dans params.

Clé	Type	Obligatoire	Par défaut	Description
model	string	Oui	suno-sounds	Utilisez suno-sounds comme ID de modèle API.
prompt	string	Oui	-	Maximum 500 caractères pour ce modèle.
params	object	Non	-	Objet de paramètres propre au modèle. Consultez les lignes ci-dessous pour les clés autorisées.
client_request_id	string	Non	-	ID côté client facultatif pour tracer les requêtes dans votre système.

Paramètres du modèle

Clé	Type	Obligatoire	Par défaut	Plage	Options	Description
model	select	Non	V5	-	V5, V5_5	Sélectionne la famille de génération Suno à utiliser. Les versions récentes gèrent souvent mieux le style et le détail, mais peuvent différer en coût et en comportement.
soundLoop	select	Non	false	-	false, true	Lecture en boucle
soundTempo	number	Non	-	min 1 / max 300 / step 1	-	Définit le tempo en battements par minute. Les valeurs plus élevées donnent généralement une sensation plus rapide et sont plus utiles pour le sound design rythmique.
soundKey	select	Non	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	Définit la tonalité musicale. Indiquez-la seulement si le résultat doit correspondre à une harmonie ou une mélodie existante ; sinon, il est généralement plus sûr de laisser le champ ouvert.

Requête minimale

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

Réponse de création

L'endpoint de création renvoie un ID de tâche public. Interrogez l'endpoint de statut jusqu'à ce que la tâche réussisse ou échoue.

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

Erreurs courantes

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found