Get songs or Instrumental or extend
POST
https://api.sunosay.com/suno/music/get-task
Get the generated song or Instrumental or extend
Request Header
| Header Name | type | Required | Description |
|---|---|---|---|
| Authorization | string | true | request verification authorization |
Request Parameters
| Params Name | type | Required | Description |
|---|---|---|---|
| task_id | string | true | The task_id created by the previous request |
Sample Parameters
{
"task_id": "976bdbf8-b5c9-4eda-b5cd-40f0e8fc875e"
}
Sample Response
Different status codes click to view
{
// Response code indicating success
"code": 200,
// Unique identifier for the task
"task_id": "4976bdbf8-b5c9-4eda-b5131-40f0e8fc875e",
// Status of the task
"status": "complete",
"prompt": {
// Prompt used for audio generation
"prompt": "This song is like an old house, quietly telling the story of the years. It has witnessed the family's laughter and carried countless dreams and hopes, and every brick and tile is saturated with the temperature of life. From the kitchen in the morning light to the study at night"
},
"clips": [
{
// Unique identifier for the audio clip
"continue_clip_id": "186001a9-c83a492a-40ac-1afd-5aaca",
// Title of the audio clip (optional)
"title": "",
// Status of the audio clip processing
"status": "complete",
// URL of the audio file
"audio_url": "https://cdn1.suno.ai/c83a492a-431ac-4606-a1c3-76487a84aa2a.mp3",
// URL of the image associated with the audio clip
"image_url": "https://cdn1.suno.ai/image_c834192a-40a51-4606-a1c3-76487a134aca.png",
// URL of the video associated with the audio clip (if any)
"video_url": "https://cdn1.suno.ai/c834122a-40ac-4606-231c3-7648413a85aaca.mp4",
// URL of the large version of the image
"image_large_url": "https://cdn1.suno.ai/image_large_c411412a-40ac-4606-a1c3-76441a85a4112a.png",
// Audio duration (seconds)
"duration": "240",
// Date and time the audio clip was created
"created_at": "2024-07-10T13:41:18.077Z",
// Name of the model used to generate the audio clip
"model_name": "chirp-v3.5",
// Major version of the model used
"major_model_version": "v3.5"
},
{
"continue_clip_id": "186001a9-c83a492a-40ac-1afd-5aaca",
"title": "",
"status": "complete",
"audio_url": "https://cdn1.suno.ai/1860011ac-4606487a-bdcc-417914676f24.mp3",
"image_url": "https://cdn1.suno.ai/image_186606-231c3a9e2-487a-bdcc-417914676f24.png",
"video_url": "https://cdn1.suno.ai/186001aarge_87a-bdcc-417914676f24.mp4",
"image_large_url": "https://cdn1.suno.ai/image_large_186001a9-487a-bdcc--487a-bdccarge76f24.png",
"duration": "240",
"created_at": "2024-07-10T13:41:18.077Z",
"model_name": "chirp-v3.5",
"major_model_version": "v3.5"
}
]
}
Examples Code
node
var axios = require('axios');
var config = {
method: 'post',
url: 'https://api.sunosay.com/suno/music/get-task',
headers: {
Authorization: 'Bearer your-api-key',
},
data: {
task_id: '976bdbf8-b5c9-4eda-b5cd-40f0e8fc875e',
},
};
axios(config)
.then(function (response) {
console.log(JSON.stringify(response.data));
})
.catch(function (error) {
console.log(error);
});