> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Intégration et utilisation de l’API Suno Tasks

> Suno Music Generation API guide - Ace Data Cloud

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](https://platform.acedata.cloud/console/applications) pour obtenir votre API Token, à conserver pour une utilisation ultérieure.

![](https://cdn.acedata.cloud/dvc3cg.jpg)

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](https://platform.acedata.cloud/console/coin).

> 📘 Documentation complète : [API Suno Audios Generation →](https://platform.acedata.cloud/documents/suno-audios)

## 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](https://platform.acedata.cloud/documents/suno-audios-integration). Pour savoir comment utiliser l’API Suno Lyrics Generation, veuillez consulter [API Suno Lyrics Generation](https://platform.acedata.cloud/documents/suno-lyrics-generation-integration).

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

![](https://cdn.acedata.cloud/bc6754.png)

### 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 :

![](https://cdn.acedata.cloud/uo7t6n.png)

### 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 :

![](https://cdn.acedata.cloud/p6vi9o.png)

Voici quelques exemples de code :

#### CURL

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/suno/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "eae26f89-b64b-404d-a80c-761996660b1c",
  "action": "retrieve"
}'
```

#### Python

```python theme={null}
import requests

url = "https://api.acedata.cloud/suno/tasks"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "id": "eae26f89-b64b-404d-a80c-761996660b1c",
    "action": "retrieve"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)
```

### 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 :

```json theme={null}
{
  "_id": "66d2add5550a4144a5a88dfe",
  "id": "eae26f89-b64b-404d-a80c-761996660b1c",
  "api_id": "09a26295-5972-4392-9318-dcd9b218f90d",
  "application_id": "ab46a066-ad82-4180-b66b-49dedf8e8a2f",
  "created_at": 1725083093.077,
  "started_at": 1725083093.137,
  "finished_at": 1725083131.537,
  "elapsed": 38.4,
  "credential_id": "66614a7e-e624-494e-87a3-387099b8cbb4",
  "request": {
    "action": "generate",
    "prompt": "A song for Christmas"
  },
  "trace_id": "e13d385a-077e-4376-be01-3465b61ca0fd",
  "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
  "response": {
    "success": true,
    "task_id": "eae26f89-b64b-404d-a80c-761996660b1c",
    "data": [
      {
        "id": "b8a4f691-4b14-4120-a7e1-a54a27a0e57e",
        "title": "Holiday Wishes",
        "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
        "lyric": "[Verse]\nSnow is falling soft and white\nLights are twinkling oh so bright\nKids are laughing full of cheer\nChristmas time is finally here\n[Verse 2]\nBells are ringing in the night\nFireplace is warm with light\nCarols sung by the tree\nEveryone's together we agree\n[Chorus]\nHoliday wishes come true\nTime to share the joy with you\nSmiles and hugs for everyone\nMerry Christmas let's have fun\n[Verse 3]\nGifts are wrapped with loving care\nMagic's floating in the air\nCookies baking in the oven\nChristmas love to be given\n[Chorus]\nHoliday wishes come true\nTime to share the joy with you\nSmiles and hugs for everyone\nMerry Christmas let's have fun\n[Bridge]\nStars are shining in the sky\nHold your loved ones don't ask why\nHeart to heart we're all united\nOn this night we are delighted",
        "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
        "video_url": "https://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4",
        "created_at": "2024-08-31T05:44:54.806Z",
        "model": "chirp-v3.5",
        "prompt": "A song for Christmas",
        "style": "pop",
        "duration": 154.44
      },
      {
        "id": "1a3343b2-2c24-4584-a2a7-687e2f97f09e",
        "title": "Holiday Wishes",
        "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
        "lyric": "[Verse]\nSnow is falling soft and white\nLights are twinkling oh so bright\nKids are laughing full of cheer\nChristmas time is finally here\n[Verse 2]\nBells are ringing in the night\nFireplace is warm with light\nCarols sung by the tree\nEveryone's together we agree\n[Chorus]\nHoliday wishes come true\nTime to share the joy with you\nSmiles and hugs for everyone\nMerry Christmas let's have fun\n[Verse 3]\nGifts are wrapped with loving care\nMagic's floating in the air\nCookies baking in the oven\nChristmas love to be given\n[Chorus]\nHoliday wishes come true\nTime to share the joy with you\nSmiles and hugs for everyone\nMerry Christmas let's have fun\n[Bridge]\nStars are shining in the sky\nHold your loved ones don't ask why\nHeart to heart we're all united\nOn this night we are delighted",
        "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
        "video_url": "https://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4",
        "created_at": "2024-08-31T05:44:54.806Z",
        "model": "chirp-v3.5",
        "prompt": "A song for Christmas",
        "style": "pop",
        "duration": 147.16
      }
    ]
  }
}
```

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 :

![](https://cdn.acedata.cloud/dqeknz.png)

### 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 :

![](https://cdn.acedata.cloud/1yk792.png)

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 :

```json { theme={null}
  "items": [
    {
      "_id": "66d2add5550a4144a5a88dfe",
      "id": "eae26f89-b64b-404d-a80c-761996660b1c",
      "api_id": "09a26295-5972-4392-9318-dcd9b218f90d",
      "application_id": "ab46a066-ad82-4180-b66b-49dedf8e8a2f",
      "created_at": 1725083093.077,
      "started_at": 1725083093.137,
      "finished_at": 1725083131.537,
      "elapsed": 38.4,
      "credential_id": "66614a7e-e624-494e-87a3-387099b8cbb4",
      "request": {
        "action": "generate",
        "prompt": "A song for Christmas"
      },
      "trace_id": "e13d385a-077e-4376-be01-3465b61ca0fd",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "response": {
        "success": true,
        "task_id": "eae26f89-b64b-404d-a80c-761996660b1c",
        "data":
[
          {
            "id": "b8a4f691-4b14-4120-a7e1-a54a27a0e57e",
            "title": "Vœux de fêtes",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "lyric": "[Couplet]\nLa neige tombe douce et blanche\nLes lumières scintillent si fort\nLes enfants rient pleins de joie\nLe temps de Noël est enfin là\n[Couplet 2]\nLes cloches sonnent dans la nuit\nLa cheminée est chaude de lumière\nDes chants de Noël chantés près du sapin\nTout le monde est ensemble, nous sommes d'accord\n[Refrain]\nLes vœux de fêtes se réalisent\nIl est temps de partager la joie avec toi\nDes sourires et des câlins pour tout le monde\nJoyeux Noël, amusons-nous\n[Couplet 3]\nLes cadeaux sont emballés avec amour\nLa magie flotte dans l'air\nDes biscuits cuisent dans le four\nDe l'amour de Noël à donner\n[Refrain]\nLes vœux de fêtes se réalisent\nIl est temps de partager la joie avec toi\nDes sourires et des câlins pour tout le monde\nJoyeux Noël, amusons-nous\n[Pont]\nLes étoiles brillent dans le ciel\nTiens tes proches, ne demande pas pourquoi\nCœur à cœur, nous sommes tous unis\nEn cette nuit nous sommes ravis",
            "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
            "video_url": "https://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4",
            "created_at": "2024-08-31T05:44:54.806Z",
            "model": "chirp-v3.5",
            "prompt": "Une chanson pour Noël",
            "style": "pop",
            "duration": 154.44
          }, {
            "id": "1a3343b2-2c24-4584-a2a7-687e2f97f09e",
            "title": "Vœux de fêtes",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "lyric": "[Couplet]\nLa neige tombe douce et blanche\nLes lumières scintillent si fort\nLes enfants rient pleins de joie\nLe temps de Noël est enfin là\n[Couplet 2]\nLes cloches sonnent dans la nuit\nLa cheminée est chaude de lumière\nDes chants de Noël chantés près du sapin\nTout le monde est ensemble, nous sommes d'accord\n[Refrain]\nLes vœux de fêtes se réalisent\nIl est temps de partager la joie avec toi\nDes sourires et des câlins pour tout le monde\nJoyeux Noël, amusons-nous\n[Couplet 3]\nLes cadeaux sont emballés avec amour\nLa magie flotte dans l'air\nDes biscuits cuisent dans le four\nDe l'amour de Noël à donner\n[Refrain]\nLes vœux de fêtes se réalisent\nIl est temps de partager la joie avec toi\nDes sourires et des câlins pour tout le monde\nJoyeux Noël, amusons-nous\n[Pont]\nLes étoiles brillent dans le ciel\nTiens tes proches, ne demande pas pourquoi\nCœur à cœur, nous sommes tous unis\nEn cette nuit nous sommes ravis",
            "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
            "video_url": "https://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4",
            "created_at": "2024-08-31T05:44:54.806Z",
            "model": "chirp-v3.5",
            "prompt": "Une chanson pour Noël",
            "style": "pop",
            "duration": 147.16
          }
        ]
      }
    }, {
      "_id": "66d2b03c550a4144a5a8d93d",
      "id": "0d3ed03b-912b-4f7d-941b-8441323cb77b",
      "api_id": "09a26295-5972-4392-9318-dcd9b218f90d",
      "application_id": "ab46a066-ad82-4180-b66b-49dedf8e8a2f",
      "created_at": 1725083708.53,
      "started_at": 1725083708.59,
      "finished_at": 1725083746.99,
      "elapsed": 38.4,
      "credential_id": "66614a7e-e624-494e-87a3-387099b8cbb4",
      "request": {
        "action": "générer",
        "prompt": "la la la"
      },
      "trace_id": "29ebb919-1126-4156-86cc-4ad899432a8c",
      "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
      "response": {
        "success": true,
        "task_id": "0d3ed03b-912b-4f7d-941b-8441323cb77b",
        "data": [
          {
            "id": "b4f498b2-e86f-4172-926a-39da9df84dd3",
            "title": "La La La",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "lyric": "[Couplet]\nJe me réveille chaque matin\nJe regarde par la fenêtre\nLe soleil brille de mille feux\nLe début d'un nouveau jour\n[Couplet 2]\nLes oiseaux chantent joyeusement\nJe danse dans le jardin\nDe belles fleurs m'entourent\nChaque moment ici est à moi\n[Refrain]\nLa la la la la la\nChante avec moi\nNe t'arrête pas\nLa la la la la la\nRéjouis-toi en profitant de la vie\n[Couplet 3]\nLa mer bleue et vaste\nLes vagues déferlent doucement\nNous marchons sur les plages\nPeu importe le temps\n[Pont]\nSaisis chaque heure\nÉcoute mes chants\nSens-toi libre\nHeureux\nDanse au rythme maintenant\n[Refrain]\nLa la la la la la\nChante avec moi\nNe t'arrête pas\nLa la la la la la\nRéjouis-toi en profitant de la vie",
            "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
            "video_url": "https://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4",
            "created_at": "2024-08-31T05:55:09.345Z",
            "model": "chirp-v3.5",
            "prompt": "la la la",
            "style": "pop",
            "duration": 154.32
          },
{
            "id": "8b44fdf1-3b88-47ac-a351-7c4b4de60549",
            "title": "La La La",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "lyric": "[Verse]\nMi vekiĝas ĉiumatene\nRigardas tra la fenestro\nSunbrilo brilanta hela\nKomenco de nova tago\n[Verse 2]\nLa birdoj kantas ĝoje\nMi dancas en la ĝardeno\nĈirkaŭas min floroj belaj\nĈiu momento ĉi estas mia\n[Chorus]\nLa la la la la la\nKantu kun mi\nNe haltu\nLa la la la la la\nĜoju ĝuante la vivon\n[Verse 3]\nLa maro blua kaj vasta\nOndoj tajdas dolĉe\nNi promenas sur plaĝoj\nSendepende de la tempo\n[Bridge]\nKaptu ĉiun horon\nAŭdu miajn kantadojn\nSentu vin libera\nFeliĉa\nDancu laŭ la ritmo nun\n[Chorus]\nLa la la la la la\nKantu kun mi\nNe haltu\nLa la la la la la\nĜoju ĝuante la vivon",
            "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3",
            "video_url": "https://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4",
            "created_at": "2024-08-31T05:55:09.345Z",
            "model": "chirp-v3.5",
            "prompt": "la la la",
            "style": "pop",
            "duration": 177.36
          }
        ]
      }
    }
  ],
  "count": 2
}
```

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

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/suno/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["eae26f89-b64b-404d-a80c-761996660b1c","0d3ed03b-912b-4f7d-941b-8441323cb77b"],
  "action": "retrieve_batch"
}'
```

#### Python

```python theme={null}
import requests

url = "https://api.acedata.cloud/suno/tasks"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "ids": ["eae26f89-b64b-404d-a80c-761996660b1c","0d3ed03b-912b-4f7d-941b-8441323cb77b"],
    "action": "retrieve_batch"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)
```

## 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

```json theme={null}
{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}
```

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.