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

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 :

{
 "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"
 },
 "data": [
 {
 "id": "clip_xxx",
 "title": "夏日海风",
 "audio_url": "https://example.com/audio.mp3",
 "image_url": "https://example.com/cover.jpg",
 "model_name": "suno-v5",
 "metadata": {
 "duration": 180,
 "prompt": "轻快电子流行，夏日海边，女声 旋律"
 }
 }
 ]
 }
}