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).

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. S’il manque ou si la source ne peut pas ê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).
string
Paroles du segment de remplacement.
integer
requis
Point de départ du remplacement (secondes). S’il manque, renvoie 400 immédiatement.
integer
requis
Point de fin du remplacement (secondes). S’il manque, renvoie 400 immédiatement.
string
défaut:"v5.5"
Version de génération : v4 / v4.5+ / v5 / v5.5 ; par défaut v5.5 si non fournie. Toute autre valeur (y compris v3.5 / v4.5 / v4.5-all) renvoie 400 directement au moment de la soumission.
string
Paroles de contexte.
string
Titre.
string
Tags de style.
string
Tags de style à exclure.
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 (la génération musicale prend généralement 30 à 120 s ; pendant la génération, status est pending et progress passe de en file 10 → prêt 50 → terminé 100). Une fois terminé, récupérez le audio_url remplacé dans data.result.music[]. En cas d’échec, data.error.message en donne 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