Récupérer une tâche
Récupérez le statut et le résultat d’une tâche Suno MJ à partir de son ID. Les champs de résultat varient selon le type de tâche.
Utilisez l’ID de tâche renvoyé par l’interface de soumission pour récupérer son statut et son résultat.
/suno/mj/fetch/{job_id}Authentification
bearerAuth Authentification avec Authorization: Bearer your-api-key.
Emplacement: header
Paramètres de chemin
ID de tâche renvoyé par l’interface de soumission ; lisez jobId ou job_id selon la réponse concernée. Il ne s’agit pas d’un ID de piste.
Corps de réponse
application/json
application/json
application/json
ID de tâche et ID de piste
| Identifiant | Utilisation |
|---|---|
jobId / job_id | ID de tâche permettant de récupérer le statut et le résultat ; lisez-le dans la réponse réelle de l’interface de soumission concernée. |
music_id / musicId | ID de piste utilisé pour les reprises, le prolongement, l’ajout de voix ou d’accompagnement. |
Téléverser un audio de référence prend en charge les modes synchrone et asynchrone. Un succès synchrone renvoie directement un ID de piste ; après un téléversement asynchrone terminé, l’ID de piste se trouve dans data.data.data.musics[].musicId de la réponse de récupération. N’utilisez pas un ID de piste comme ID de tâche pour la récupération. Pour plusieurs tâches, utilisez Récupérer les tâches par lot.
Statuts et résultats
| Statut | Signification |
|---|---|
NOT_START | La tâche a été créée ; le traitement n’a pas encore commencé. |
QUEUED | La tâche est en attente dans la file. |
ON_QUEUE | En attente dans la file. |
SUCCESS | La tâche a réussi ; lisez le résultat correspondant à son type. |
FAILED | La tâche a échoué ; consultez l’erreur renvoyée par la tâche. |
Dans la réponse de soumission, status: SUCCESS signifie que la requête a été acceptée, et non que la tâche asynchrone est terminée. Au niveau le plus externe de la réponse de récupération, code: success indique que la requête de récupération a réussi ; lisez le statut de la tâche dans data.status. Une fois une tâche musicale ou un téléversement asynchrone terminé, les pistes se trouvent dans data.data.data.musics[]. Le musicId de chaque piste sert aux opérations suivantes et audioUrl pointe vers l’audio ; en l’absence de titre, title peut être null. Les champs de résultat des autres types de tâche peuvent être différents : ne leur appliquez pas directement cette structure.
Notifications de callback
Vous pouvez renseigner hookUrl dans la requête de soumission pour recevoir les notifications de tâche relayées par la plateforme. L’adresse de callback prend uniquement en charge les ports 80, 443, 8080 et 8443.
Si hookUrl n’est pas renseigné, vous pouvez récupérer la tâche vous-même ; les mises à jour de statut peuvent être retardées. Même avec un callback configuré, vous pouvez utiliser l’interface de récupération pour obtenir le résultat. La configuration du callback est définie par hookUrl dans la requête de soumission ; n’utilisez pas data.hookUrl de la réponse de récupération pour déterminer l’adresse de callback.