POST
/
api
/
v1
/
lyrics
Generate Lyrics
curl --request POST \
  --url https://api.sunoapi.org/api/v1/lyrics \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A song about peaceful night in the city",
  "callBackUrl": "https://api.example.com/callback"
}'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "5c79****be8e"
  }
}

​
Usage Guide

  • This endpoint generates only lyrics content based on your prompt
  • Multiple lyrics variations will be returned for you to choose from
  • Generated lyrics typically include song structure markers (e.g., [Verse], [Chorus])

​
Developer Notes

  1. Generated lyrics are retained for 15 days
  2. Callback has only one stage: complete (generation complete)
  3. Use this endpoint when you only need lyrics creation without music
  4. Results can be used as input for the Generate Music endpoint in custom mode

Authorizations

​
Authorization
string
header
required

🔑 API Authentication

All endpoints require authentication using Bearer Token.

Get API Key

  1. Visit the API Key Management Page to obtain your API Key

Usage

Add to request headers:

Authorization: Bearer YOUR_API_KEY

⚠️ Note:

  • Keep your API Key secure and do not share it with others
  • If you suspect your API Key has been compromised, reset it immediately from the management page

Body

application/json

Response

Request successful

The response is of type object.