Skip to main content
POST
Référencer la piste source : les opérations basées sur un morceau existant ne nécessitent de mémoriser aucun id supplémentaire, il suffit de passer task_id (le task_id correspondant à la tâche qui a produit la piste source) + audio_index (le numéro du morceau dans music[] des résultats, indexé à partir de 1, 1 par défaut).
Ce point de terminaison n’a aucune dimension de version : ne passez pas version — s’il est passé, il est ignoré et n’affecte pas la facturation.

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
Le task_id de notre côté correspondant à la tâche qui a produit la piste source. En cas d’absence ou si la source ne peut être résolue, un 400 est renvoyé au moment de la soumission.
integer
défaut:"1"
Quel morceau du data.music[] du résultat de la tâche source (indexé à partir de 1 ; par défaut 1 ; une génération produit généralement 2 morceaux : index 1 et 2).
integer
requis
Point de départ du recadrage (secondes). En cas d’absence, renvoie immédiatement un 400.
integer
requis
Point de fin du recadrage (secondes). En cas d’absence, renvoie immédiatement un 400.
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 (prend généralement 30 à 120 s ; pendant la génération, status est pending et progress passe de file d’attente 10 → prêt 50 → terminé 100). Une fois terminé, récupérez le audio_url recadré 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