Skip to main content
POST
Cette interface n’a pas de dimension de version : ne passez pas version — s’il est fourni, il est ignoré et n’a aucun impact sur la facturation.
Limitation connue : ne téléversez pas d’audio purement instrumental (sans voix) — l’analyse peut échouer.

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
requis
URL audio directe accessible publiquement. Si elle manque, un 400 est renvoyé dès la soumission (aucune facturation).
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 passe de 10 en file d’attente → 50 prêt → 100 terminé). Une fois terminé, utilisez le task_id de cette tâche + audio_index=1 comme source pour d’autres opérations. 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