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:"v6"
Version publique : v6 / v6-wild / v6-mini ; valeur par défaut si omise : v6.
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, 1–300 ; 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).
string
Format audio de sortie : mp3 / m4a / wav.
Cette API ne prend en charge ni les modèles personnalisés, ni Max, ni variety, ni la durée cible.
Obtenir le résultat : cette API crée une tâche asynchrone. Après la soumission, interrogez GET /v1/music/tasks/{task_id} toutes les 3 à 5 secondes jusqu’à ce que status soit completed ou failed. Pendant le traitement, status peut être pending ou processing ; progress est un entier de 0 à 100, sans progression par paliers fixes garantie. Une fois la tâche terminée, lisez audio_url dans data.result.music[]. En cas d’échec, le motif se trouve dans data.error.message et le montant débité est remboursé automatiquement.

Response

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