Passer au contenu principal
POST
Référencer la piste source : les opérations basées sur un morceau existant ne nécessitent de mémoriser aucun id en amont, il suffit de passer task_id (le task_id de notre côté 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.
Prérequis : concat ne peut assembler que des segments produits par extend (continuation). Si la source n’est pas un produit d’extend (par ex. un morceau complet généré en une seule fois), la requête est rejetée à la soumission avec un 400 et l’amont n’est pas appelé.

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).
task_id
string
requis
Le task_id de notre côté correspondant à la tâche source — doit être un segment produit par extend (continuation) (voir l’avertissement ci-dessus). En cas d’absence, si ce n’est pas un produit d’extend, ou si la source ne peut être résolue, un 400 est renvoyé au moment de la soumission.
audio_index
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).
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 de la chanson complète dans data.result.music[]. 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