Create
POST
https://api.sunoapi.com/api/v2/suno/v3.0/custom/create-lyrics-song
The core API to generates custom songs based on prompt, tags and title.
POST /api/v2/suno/v3.0/custom/create-lyrics-song
Sample Request
{
"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",
"tags": "epic reggae",
"title": "Electric Dreams"
}Request Body
| Name | Type | Required | Default |
|---|---|---|---|
| prompt | string | true | "" |
| tags | string | true | "" |
| title | string | false | "" |
prompt
The lyrics of the song.
tags
Style of Music. e.g. "heavy metal", "gospel", "jazz", etc.
title
The title of the song.
Sample Response
{
"code": 200,
"data": {
"task_id": "b09d79f9-bd8f-4d51-8e8e-a7e1cb22f139"
},
"message": "success"
}Response Body
| Name | Type | Description |
|---|---|---|
| code | number | the HTTP status code of the response |
| data | object | the data of the response |
| message | string | the message of the response |
data
| Name | Type | Description |
|---|---|---|
| task_id | string | the task ID of the song generation job |
task_id
The task ID of the song generation job, which can be used to query the progress of the job and retrieve the generated song. You can use this ID to retrieve the song from the API clip.
Examples
const axios = require("axios")
const config = {
method: "post",
url: "https://api.sunoapi.com/api/v2/suno/v3.0/custom/create-lyrics-song",
headers: {
"Content-Type": "application/json",
Authorization: "Bearer <your-token>",
},
data: {
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",
tags: "epic reggae",
title: "Electric Dreams",
},
}
axios(config)
.then(function (response) {
console.log(JSON.stringify(response.data))
})
.catch(function (error) {
console.log(error)
})