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 endpoint n’a aucune dimension de version : ne passez pas version — s’il est passé, il est ignoré et n’affecte pas la facturation.

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 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.
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).
name
string
requis
Nom de la persona ; s’il manque, renvoie 400 immédiatement sans appeler l’upstream.
describe
string
Description.
styles
string
Style.
vox_audio_id
string
Id obtenu via « Extraire Vox ».
vocal_start_s
integer
Début de l’extrait vocal (secondes). Lorsque vous référencez vox_audio_id, cela doit correspondre à la plage de l’extrait utilisée lors de l’extraction de ce Vox.
vocal_end_s
integer
Fin de l’extrait vocal (secondes). Lorsque vous référencez vox_audio_id, cela doit correspondre à la plage de l’extrait utilisée lors de l’extraction de ce Vox.
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 en file 10 → prêt 50 → terminé 100). Le résultat contient les informations du persona. En cas d’échec, data.error.message en donne 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