Passer au contenu principal
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’upstream peut échouer à l’analyser.

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).
audioFilePath
string
requis
URL audio directe accessible publiquement. Si elle manque, un 400 est renvoyé dès la soumission (aucun appel à l’upstream, 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

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