Passer au contenu principal
La principale fonction de l’API Suno Tasks est de consulter le statut d’exécution d’une tâche en saisissant l’ID de tâche généré par l’API Suno Audios Generation ou l’API Suno Lyrics Generation. Ce document présentera en détail les instructions d’intégration de l’API Suno Tasks, afin de vous aider à intégrer facilement et à exploiter pleinement les puissantes fonctionnalités de cette API. Grâce à l’API Suno Tasks, vous pouvez facilement consulter le statut d’exécution des tâches de l’API Suno Lyrics Generation ou de l’API Suno Audios Generation.

​
Processus de demande

Pour utiliser l’API Suno Audios Generation, accédez d’abord à la console Ace Data Cloud pour obtenir votre API Token, à conserver pour une utilisation ultérieure. Si vous n’êtes pas encore connecté ou inscrit, vous serez automatiquement redirigé vers la page de connexion afin de vous inviter à vous inscrire et à vous connecter. Une fois cette étape terminée, vous reviendrez automatiquement à la page actuelle. Un seul API Token permet d’appeler tous les services de la plateforme, sans avoir besoin d’effectuer une demande séparée pour chaque service. Une première demande offre un quota gratuit permettant une expérience gratuite ; lorsque le quota est insuffisant, vous pouvez recharger votre solde universel dans la console.
📘 Documentation complète : API Suno Audios Generation →

​
Exemple de requête

L’API Suno Tasks peut être utilisée pour consulter les résultats des deux API Suno Audios Generation et Suno Lyrics Generation. Pour savoir comment utiliser l’API Suno Audios Generation, veuillez consulter la documentation API Suno Audios Generation. Pour savoir comment utiliser l’API Suno Lyrics Generation, veuillez consulter API Suno Lyrics Generation. Nous prenons comme exemple un ID de tâche renvoyé par le service API Suno Audios Generation, afin de démontrer comment utiliser cette API. Supposons que nous avons un ID de tâche : eae26f89-b64b-404d-a80c-761996660b1c, nous allons ensuite démontrer comment en transmettant un ID de tâche.

​
Image d’exemple de tâche

​
Définir les en-têtes et le corps de la requête

Les Request Headers comprennent :
  • accept : spécifie la réception de résultats de réponse au format JSON ; renseignez ici application/json.
  • authorization : la clé pour appeler l’API, qui peut être directement sélectionnée dans une liste déroulante après la demande.
Le Request Body comprend :
  • id : l’ID de la tâche téléversée.
  • action : le mode d’opération sur la tâche.
La configuration est illustrée ci-dessous :

​
Exemple de code

Vous pouvez constater que le code dans différents langages a déjà été généré automatiquement sur le côté droit de la page, comme illustré ci-dessous :

Voici quelques exemples de code :

​
CURL

​
Python

​
Exemple de réponse

Une fois la requête réussie, l’API renverra les informations détaillées de la tâche de chanson ici. Par exemple :
Le résultat renvoyé contient plusieurs champs. Le champ request correspond au corps de la requête lors du lancement de la tâche, tandis que le champ response correspond au corps de la réponse renvoyée une fois la tâche terminée. Les champs sont décrits ci-dessous.
  • id，l’ID de la tâche de génération de cette chanson, utilisé pour identifier de manière unique cette tâche de génération de chanson.
  • request，les informations de requête dans la tâche de requête de chanson.
  • response，les informations de réponse dans la tâche de requête de chanson.
  • created_at，l’heure de création de la tâche, horodatage Unix (secondes, flottant).
  • started_at，l’heure à laquelle la tâche commence à être exécutée, horodatage Unix (secondes, flottant).
  • finished_at，l’heure de fin de la tâche, horodatage Unix (secondes, flottant). Ce champ n’est pas renvoyé lorsque la tâche n’est pas terminée.
  • elapsed，le temps d’exécution de la tâche, en secondes (flottant, conservant 3 décimales). Ce champ n’est pas renvoyé lorsque la tâche n’est pas terminée.

​
Opération de requête par lots

Ceci permet de consulter les détails des tâches de chansons pour plusieurs ID de tâches. La différence avec ce qui précède est que action doit être sélectionné comme retrieve_batch. Request Body comprend :
  • ids：le tableau des ID de tâches téléversés.
  • action：le mode d’opération sur les tâches.
Configurez comme indiqué dans l’image ci-dessous :

​
Exemple de code

Vous pouvez constater que le code dans différents langages a été généré automatiquement sur le côté droit de la page, comme indiqué dans l’image ci-dessous :

Voici quelques exemples de code :

​
Exemple de réponse

Une fois la requête réussie, l’API renverra les informations détaillées spécifiques de toutes les tâches de chansons par lots. Par exemple :
Le résultat renvoyé comporte plusieurs champs, parmi lesquels items contient les informations détaillées spécifiques des tâches de chansons par lot. Les informations spécifiques de chaque tâche de chanson sont identiques aux champs ci-dessus, et les informations des champs sont les suivantes.
  • items, toutes les informations détaillées spécifiques des tâches de chansons par lot. Il s’agit d’un tableau, et chaque élément du tableau a le même format que le résultat renvoyé pour la requête d’une seule tâche ci-dessus.
  • count, le nombre de tâches de chansons interrogées par lot ici.

​
CURL

​
Python

​
Gestion des erreurs

Lors de l’appel de l’API, en cas d’erreur, l’API renverra le code d’erreur et les informations correspondants. Par exemple :
  • 400 token_mismatched：Requête incorrecte, peut-être en raison de paramètres manquants ou non valides.
  • 400 api_not_implemented：Requête incorrecte, peut-être en raison de paramètres manquants ou non valides.
  • 401 invalid_token：Non autorisé, jeton d’autorisation non valide ou manquant.
  • 429 too_many_requests：Trop de requêtes, vous avez dépassé la limite de débit.
  • 500 api_error：Erreur interne du serveur, quelque chose s’est mal passé sur le serveur.

​
Exemple de réponse d’erreur

​
Conclusion

Grâce à ce document, vous avez appris à utiliser l’API Suno Tasks pour interroger toutes les informations détaillées spécifiques d’une tâche de chanson unique ou de tâches de chansons par lot. Nous espérons que ce document vous aidera à mieux intégrer et utiliser cette API. Si vous avez des questions, veuillez contacter notre équipe de support technique à tout moment.