Get Generated Lyrics
GET
https://api.sunoapi.com/api/v1/suno/get-lyrics/{taskId}Retrieve progress and response from a task you've sent in a previous make-lyrics request.
GET /api/v1/suno/get-lyrics/{taskId}
Request Param
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| taskId | path | string | true | the task ID from the make-lyrics request |
Sample Response
{
"code": 200,
"data": {
"task_id": "3d51f2fb-2a52-4207-9808-a3aa7c9f64ce",
"input": "{\"prompt\":\"run away\"}",
"status": "completed",
"title": "Run Away",
"text": "[Verse]\nRunning through the open sky\nFeel the wind and just get by\nLeave the past and don't look back\nRun away on this new track\n\n[Verse 2]\nStars above they light our way\nNo more shadows come what may\nDust behind let's find our dreams\nRun away on silver beams\n\n[Chorus]\nRun away run away\nTo where the sun meets the day\nNo more chains no more ties\nRun away to clear skies\n\n[Verse 3]\nMountains call us to the peak\nIn their whispers futures speak\nClimbing high and free we soar\nRun away forevermore\n\n[Bridge]\nHands together hearts so free\nAll we're chasing yet to see\nBrave the unknown side by side\nRun away let's take this ride\n\n[Chorus]\nRun away run away\nTo where the sun meets the day\nNo more chains no more ties\nRun away to clear skies",
"metadata": {
"created_at": "2024-07-08T12:39:14.870428366Z",
"started_at": "2024-07-08T12:39:14.999158689Z",
"ended_at": "2024-07-08T12:39:28.525071323Z",
"quota_frozen": 0,
"quota_usage": 0
}
},
"message": "success"
}Response Body
| Name | Type | Description |
|---|---|---|
| code | number | the task ID from the make-lyrics request |
| data | object | the generated lyrics |
| message | string | whether the mission was successful, can be success or failed |
data
| Name | Type | Description |
|---|---|---|
| task_id | string | the task ID from the make-lyrics request |
| status | string | the status of the task, can be completed or processing |
| input | string | the request details used to generate the lyrics |
| title | string | the generated lyrics title |
| text | string | the generated lyrics |
| metadata | string | the metadata of the generation, including created_at, started_at, ended_at, quota_frozen, quota_usage |
| metadata.created_at | string | the start time of generation |
| metadata.ended_at | string | the end time of generation |
| metadata.quota_frozen | string | the frozen quota of this generation, you can ignore |
| metadata.quota_usage | boolean | the usage quota of this generation, you can ignore |
Examples
const axios = require("axios")
const config = {
method: "get",
url: "https://api.sunoapi.com/api/v1/suno/get-lyrics/3d51f2fb-2a52-4207-9808-a3aa7c9f64ce",
headers: {
Authorization: "Bearer <your-token>",
},
}
axios(config)
.then(function (response) {
console.log(JSON.stringify(response.data))
})
.catch(function (error) {
console.log(error)
})