Passer au contenu principal
POST

Authorizations

Authorization
string
requis
Toutes les interfaces nécessitent une authentification via Bearer TokenObtenir la clé API :Rendez-vous sur la page de gestion des clés API pour obtenir votre clé APILors de l’utilisation, ajoutez dans l’en-tête de la requête :

Body

model
string
défaut:"suno"
Modèle audio. Actuellement, passez suno (par défaut suno si non fourni).
version
string
défaut:"v5.5"
Version de génération : uniquement v5 / v5.5 ; si non fournie, v5.5 par défaut.
prompt
string
requis
Description de l’effet sonore (mappée sur le sound de l’upstream). S’il manque, un 400 est renvoyé dès la soumission (aucun appel à l’upstream, aucune facturation).
type
string
défaut:"one-shot"
Type d’effet sonore : one-shot (par défaut, coup unique) / loop (bouclable).
bpm
integer
Tempo, 1300 ; les valeurs hors plage renvoient directement 400 dès la soumission.
key
string
Énumération des tonalités : tonalités majeures C / C# / D / D# / E / F / F# / G / G# / A / A# / B ; tonalités mineures avec m en suffixe (Cm / C#m / … / Bm). Seule la notation avec dièses (#) est prise en charge ; les bémols (Db / Eb, etc.) et B# renvoient 400 (key param error).
Récupérer le résultat : cette interface est une tâche asynchrone. Après soumission, vous obtenez un task_id ; interrogez GET /v1/music/tasks/{task_id} à intervalles de 3 à 5 s jusqu’à ce que status soit completed ou failed (pendant la génération, status est pending et progress évolue : en file d’attente 10 → prêt 50 → terminé 100). Une fois terminé, récupérez audio_url dans data.result.music[]. En cas d’échec, data.error.message indique la raison et le quota pré-déduit est automatiquement remboursé.

Response

code
integer
Code de statut de la réponse
data
array
Tableau de données renvoyées