Get Generated Music
GET
https://api.sunoapi.com/api/v2/suno/v3.0/clip/{taskId}Retrieve progress and response from a task you've sent in a previous create request.
Each create action will result in 2 clips, each with a unique clip ID, mp4 URL, cover image, audio URL and more.
GET /api/v2/suno/v3.0/clip/{taskId}
Request Param
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| taskId | path | string | true | the task ID from the create request |
Sample Response
{
"code": 200,
"data": {
"task_id": "b09d79f9-bd8f-4d51-8e8e-a7e1cb22f139",
"status": "completed",
"input": "{\"custom_mode\":true,\"gpt_description_prompt\":\"\",\"make_instrumental\":false,\"prompt\":\"[Verse]\\nTesla riding\\nBatteries flying\\nElon Musk\\nHe's got the future on his mind\\nSolar panels shining\\nRockets reaching for the skies\\nInnovation's flowing\\nHe's the tech wizard of our times\\n\\n[Verse]\\nNeuralink connecting minds\\nAI running wild\\nMars colonization\\nHe's making it his style\\nFrom PayPal he came and shook the world with his touch\\nElon Musk\\nThe eccentric genius\\nHe's too much\\n\\n[Chorus]\\nElon Musk\\nHe's the man with electric dreams\\nChanging the world with his technology schemes\\nFrom PayPal to SpaceX\\nHe's a force to be seen\\nElectric cars and rockets\\nHe's living the dream\",\"title\":\"Electric Dreams\",\"continue_at\":0,\"continue_clip_id\":\"\",\"mv\":\"chirp-v3-0\",\"tags\":\"epic reggae\"}",
"clips": {
"b6cddf85-7d84-4e99-98d7-7e54bba8a7b1": {
"id": "b6cddf85-7d84-4e99-98d7-7e54bba8a7b1",
"video_url": "https://cdn1.suno.ai/b6cddf85-7d84-4e99-98d7-7e54bba8a7b1.mp4",
"audio_url": "https://cdn1.suno.ai/b6cddf85-7d84-4e99-98d7-7e54bba8a7b1.mp3",
"image_url": "https://cdn1.suno.ai/image_b6cddf85-7d84-4e99-98d7-7e54bba8a7b1.png",
"image_large_url": "https://cdn1.suno.ai/image_large_b6cddf85-7d84-4e99-98d7-7e54bba8a7b1.png",
"is_video_pending": true,
"major_model_version": "v3",
"model_name": "chirp-v3",
"metadata": {
"tags": "epic reggae",
"prompt": "[Verse]\nTesla riding\nBatteries flying\nElon Musk\nHe's got the future on his mind\nSolar panels shining\nRockets reaching for the skies\nInnovation's flowing\nHe's the tech wizard of our times\n\n[Verse]\nNeuralink connecting minds\nAI running wild\nMars colonization\nHe's making it his style\nFrom PayPal he came and shook the world with his touch\nElon Musk\nThe eccentric genius\nHe's too much\n\n[Chorus]\nElon Musk\nHe's the man with electric dreams\nChanging the world with his technology schemes\nFrom PayPal to SpaceX\nHe's a force to be seen\nElectric cars and rockets\nHe's living the dream",
"gpt_description_prompt": "",
"audio_prompt_id": "",
"history": null,
"concat_history": null,
"type": "gen",
"duration": 120,
"refund_credits": false,
"stream": true,
"error_type": "",
"error_message": ""
},
"is_liked": false,
"user_id": "",
"display_name": "",
"handle": "",
"is_handle_updated": false,
"is_trashed": false,
"reaction": null,
"created_at": "2024-06-10T11:27:54.213Z",
"status": "complete",
"title": "Electric Dreams",
"play_count": 0,
"upvote_count": 0,
"is_public": false
},
"e361faeb-472e-48fb-98ff-2d91332a3034": {
"id": "e361faeb-472e-48fb-98ff-2d91332a3034",
"video_url": "https://cdn1.suno.ai/e361faeb-472e-48fb-98ff-2d91332a3034.mp4",
"audio_url": "https://cdn1.suno.ai/e361faeb-472e-48fb-98ff-2d91332a3034.mp3",
"image_url": "https://cdn1.suno.ai/image_e361faeb-472e-48fb-98ff-2d91332a3034.png",
"image_large_url": "https://cdn1.suno.ai/image_large_e361faeb-472e-48fb-98ff-2d91332a3034.png",
"is_video_pending": false,
"major_model_version": "v3",
"model_name": "chirp-v3",
"metadata": {
"tags": "epic reggae",
"prompt": "[Verse]\nTesla riding\nBatteries flying\nElon Musk\nHe's got the future on his mind\nSolar panels shining\nRockets reaching for the skies\nInnovation's flowing\nHe's the tech wizard of our times\n\n[Verse]\nNeuralink connecting minds\nAI running wild\nMars colonization\nHe's making it his style\nFrom PayPal he came and shook the world with his touch\nElon Musk\nThe eccentric genius\nHe's too much\n\n[Chorus]\nElon Musk\nHe's the man with electric dreams\nChanging the world with his technology schemes\nFrom PayPal to SpaceX\nHe's a force to be seen\nElectric cars and rockets\nHe's living the dream",
"gpt_description_prompt": "",
"audio_prompt_id": "",
"history": null,
"concat_history": null,
"type": "gen",
"duration": 69.44,
"refund_credits": false,
"stream": true,
"error_type": "",
"error_message": ""
},
"is_liked": false,
"user_id": "",
"display_name": "",
"handle": "",
"is_handle_updated": false,
"is_trashed": false,
"reaction": null,
"created_at": "2024-06-10T11:27:54.213Z",
"status": "complete",
"title": "Electric Dreams",
"play_count": 0,
"upvote_count": 0,
"is_public": false
}
},
"metadata": {
"created_at": "2024-06-10T11:27:51.950042707Z",
"started_at": "2024-06-10T11:27:52.649463298Z",
"ended_at": "2024-06-10T11:29:15.030639348Z",
"quota_frozen": 5,
"quota_usage": 5
}
},
"message": "success"
}Response Body
| Name | Type | Description |
|---|---|---|
| code | number | the task ID from the create request |
| data | object | the generated clips |
| message | string | success |
data
| Name | Type | Description |
|---|---|---|
| task_id | string | the task ID from the create request |
| status | string | the status of the task, can be completed or processing |
| input | string | the request details used to generate the clips |
| clips | object | the generated clips, each clip contains the video, audio, and image URLs |
| clips.id | string | the clip ID |
| clips.video_url | string | the video URL of the clip |
| clips.audio_url | string | the audio URL of the clip |
| clips.image_url | string | the image URL of the clip |
| clips.image_large_url | string | the large image URL of the clip |
| clips.is_video_pending | boolean | whether the video is pending to be generated |
| clips.major_model_version | string | the major model version used to generate the clips |
| clips.model_name | string | the model name used to generate the clips |
| clips.metadata | object | the metadata of the clips, including tags, prompt, audio prompt ID, history, concat history, type, duration, refund credits, stream, error type, error message, etc. |
| clips.is_liked | boolean | whether the clip is liked |
| clips.user_id | string | the user ID of the clip |
| clips.display_name | string | the display name of the clip |
| clips.handle | string | the handle of the clip |
| clips.is_handle_updated | boolean | whether the handle is updated |
| clips.is_trashed | boolean | whether the clip is trashed |
| clips.reaction | object | the reaction of the clip, including upvote count, like count, and dislike count |
| clips.created_at | string | the created at of the clip |
| clips.status | string | the status of the clip, can be completed or processing |
| clips.title | string | the title of the clip |
| clips.play_count | number | the play count of the clip |
| clips.upvote_count | number | the upvote count of the clip |
| clips.is_public | boolean | whether the clip is public |
Examples
const axios = require("axios")
const config = {
method: "get",
url: "https://api.sunoapi.com/api/v2/suno/v3.0/clip/b09d79f9-bd8f-4d51-8e8e-a7e1cb22f139",
headers: {
Authorization: "Bearer <your-token>",
},
}
axios(config)
.then(function (response) {
console.log(JSON.stringify(response.data))
})
.catch(function (error) {
console.log(error)
})