Skip to main content
POST

Authorizations

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

string
défaut:"suno"
Modèle audio. Actuellement, passez suno (par défaut suno si non fourni).
string
défaut:"v5.5"
Version de génération : uniquement v5 / v5.5 ; si non fournie, v5.5 par défaut.
string
requis
Description de l’effet sonore. S’il manque, un 400 est renvoyé dès la soumission (aucune facturation). Privilégiez des prompts en anglais pour de meilleurs résultats.
string
défaut:"one-shot"
Type d’effet sonore : one-shot (par défaut, coup unique) / loop (bouclable).
integer
Tempo, 1300 ; les valeurs hors plage renvoient directement 400 dès la soumission.
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

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