> ## Documentation Index > Fetch the complete documentation index at: https://docs.aiid.edu.kg/llms.txt > Use this file to discover all available pages before exploring further. # Interroger la tâche musicale par ID > Interrogez la tâche de génération musicale via le path `task_id`. Interface de requête des tâches de génération musicale. Le `data` renvoyé par l'interface de création est l'ID de tâche ; utilisez `GET /suno/fetch/{task_id}` pour interroger une tâche unique. ## Méthodes de requête ```http GET /suno/fetch/task_xxx ``` ## Sortie de la requête La couche externe conserve la structure de tâche new-api : - `code` : vaut `success` en cas de succès. - `message` : message d’erreur ou d’information. - `data.task_id` : ID de la tâche. - `data.status` : état de la tâche, valeurs courantes `NOT_START`, `SUBMITTED`, `QUEUED`, `IN_PROGRESS`, `SUCCESS`, `FAILURE`. - `data.progress` : progression de la tâche. - `data.result_url` : adresse du résultat disponible après succès ; si l’amont renvoie plusieurs morceaux, se référer aux fragments dans `data.data`. - `data.data` : données brutes du résultat musical en amont, contenant généralement un tableau ou un objet de fragments de morceaux. Exemple d’état de succès : ```json { "code": "success", "message": "", "data": { "task_id": "task_xxx", "platform": "suno", "action": "MUSIC", "status": "SUCCESS", "progress": "100%", "result_url": "https://example.com/audio.mp3", "properties": { "upstream_model_name": "suno_music", "origin_model_name": "suno-v5.5" }, "data": [ { "id": "clip_xxx", "title": "夏日海风", "audio_url": "https://example.com/audio.mp3", "image_url": "https://example.com/cover.jpg", "model_name": "suno-v5.5", "metadata": { "duration": 180, "prompt": "轻快电子流行，夏日海边，女声 旋律" } } ] } } ``` ## OpenAPI ````yaml api-reference/fr/openapi.json GET /suno/fetch/{task_id} openapi: 3.0.0 info: title: Documentation de référence de 出海营 API version: 1.0.0 description: Public AI Gateway API Reference servers: - url: https://api.aiid.edu.kg security: - BearerAuth: [] tags: - name: OpenAIFormat (Chat) - name: Format OpenAI(Responses) - name: Format Gemini pour la génération d’images - name: Génération d’imagesOpenAI au format DALL-E - name: Obtenir la liste des modèles - name: Génération vidéoHappyHorse avec Wan - name: Format de génération vidéo Kling - name: Format Omni de génération vidéo et Veo - name: Génération vidéo Seedance - name: Formats compatibles avec la génération de vidéosSora - name: Génération vidéo Vidu - name: Format de tâche de génération musicale paths: /suno/fetch/{task_id}: get: tags: - Format de tâche de génération musicale summary: Interroger la tâche musicale par ID description: >- Interrogez la tâche de génération musicale via le path `task_id`. Interface de requête des tâches de génération musicale. Le `data` renvoyé par l'interface de création est l'ID de tâche ; utilisez `GET /suno/fetch/{task_id}` pour interroger une tâche unique. ## Méthodes de requête ```http GET /suno/fetch/task_xxx ``` ## Sortie de la requête La couche externe conserve la structure de tâche new-api : - `code` : vaut `success` en cas de succès. - `message` : message d’erreur ou d’information. - `data.task_id` : ID de la tâche. - `data.status` : état de la tâche, valeurs courantes `NOT_START`, `SUBMITTED`, `QUEUED`, `IN_PROGRESS`, `SUCCESS`, `FAILURE`. - `data.progress` : progression de la tâche. - `data.result_url` : adresse du résultat disponible après succès ; si l’amont renvoie plusieurs morceaux, se référer aux fragments dans `data.data`. - `data.data` : données brutes du résultat musical en amont, contenant généralement un tableau ou un objet de fragments de morceaux. Exemple d’état de succès : ```json { "code": "success", "message": "", "data": { "task_id": "task_xxx", "platform": "suno", "action": "MUSIC", "status": "SUCCESS", "progress": "100%", "result_url": "https://example.com/audio.mp3", "properties": { "upstream_model_name": "suno_music", "origin_model_name": "suno-v5.5" }, "data": [ { "id": "clip_xxx", "title": "夏日海风", "audio_url": "https://example.com/audio.mp3", "image_url": "https://example.com/cover.jpg", "model_name": "suno-v5.5", "metadata": { "duration": 180, "prompt": "轻快电子流行，夏日海边，女声 旋律" } } ] } } ``` parameters: - name: task_id in: path required: true schema: type: string example: task_xxx description: ID de tâche renvoyé lors de la soumission de la tâche musicale. responses: '200': description: OK content: application/json: schema: type: object properties: code: type: string example: success description: En cas de succès, `success`. message: type: string description: Message d'erreur ou de notification. data: type: object properties: task_id: type: string description: ID de la tâche. status: type: string description: >- État de la tâche, valeurs courantes `NOT_START`, `SUBMITTED`, `QUEUED`, `IN_PROGRESS`, `SUCCESS`, `FAILURE`. progress: type: string description: Progression de la tâche. result_url: type: string description: URL du résultat disponible après réussite. data: type: string items: type: object properties: audio_url: type: string description: URL de l’audio de la chanson. image_url: type: string description: URL de la pochette du morceau. title: type: string description: Titre de la chanson. metadata: type: object properties: duration: type: string description: Durée audio. examples: music_fetch_success: summary: La requête de la tâche musicale a réussi value: code: success message: '' data: task_id: task_xxx platform: suno action: MUSIC status: SUCCESS progress: 100% result_url: https://example.com/audio.mp3 properties: upstream_model_name: suno_music origin_model_name: suno-v5.5 data: - id: clip_xxx title: 夏日海风 audio_url: https://example.com/audio.mp3 image_url: https://example.com/cover.jpg model_name: suno-v5.5 metadata: duration: 180 prompt: 轻快电子流行，夏日海边，女声 旋律 components: securitySchemes: BearerAuth: type: http scheme: bearer description: |- Utilisez l'authentification Bearer Token. Format : `Authorization: Bearer sk-xxxxxx` ````