Skip to main content
POST
/
voice
/
lyrics_generator
Generate lyrics from prompt
curl --request POST \
  --url https://modelslab.com/api/v6/voice/lyrics_generator \
  --header 'Content-Type: application/json' \
  --data '
{
  "key": "<string>",
  "prompt": "<string>",
  "length": "short",
  "webhook": "<string>",
  "track_id": 123
}
'
{
  "status": "success",
  "generationTime": 123,
  "id": 123,
  "output": [
    "<string>"
  ],
  "proxy_links": [
    "<string>"
  ],
  "future_links": [
    "<string>"
  ],
  "links": [
    "<string>"
  ],
  "meta": {},
  "eta": 123,
  "message": "<string>",
  "tip": "<string>",
  "fetch_result": "<string>",
  "audio_time": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.modelslab.com/llms.txt

Use this file to discover all available pages before exploring further.

Overview

Generate structured song lyrics from a simple text prompt. Great for quickly scaffolding lyrics before feeding them into the Song Generator.
1

Provide a prompt

Describe the song topic, mood, or theme : e.g. "tokyo" or "a rainy night in Mumbai".
2

Choose length

Set length to "short" for a quick verse or "long" for full multi-section lyrics.
3

Receive lyrics

The API returns structured lyrics ready to use in your song generation workflow.
Lyrics are generated in English only.

Request

curl
--request POST 'https://modelslab.com/api/v6/voice/lyrics_generator' \

Body Parameters

key
string
required
Your API key.
prompt
string
required
Topic or theme for the lyrics. E.g. "tokyo", "heartbreak", "summer road trip".
length
string
default:"short"
Length of the generated lyrics. "short" for a single verse, "long" for full multi-section lyrics.
webhook
string
URL to receive a POST callback when generation completes.
track_id
integer
Custom ID sent with the webhook payload for request correlation.

Example Request

json
{
  "key": "your_api_key",
  "prompt": "tokyo",
  "length": "short",
  "webhook": null,
  "track_id": null
}

Body

application/json
key
string
required

Your API Key used for request authorization

prompt
string
required

Prompt to guide automatic lyrics generation

length
enum<string>
default:short

Desired length of generated lyrics

Available options:
short,
long
webhook
string<uri>

URL to receive POST notification upon completion

track_id
integer

ID returned in API response for webhook identification

Response

Lyrics generation response

status
enum<string>

Status of the voice generation

Available options:
success,
processing,
error
generationTime
number

Time taken to generate the audio in seconds

id
integer

Unique identifier for the voice generation

output
string<uri>[]

Array of generated audio URLs

Array of proxy audio URLs

Array of future audio URLs for queued requests

Array of audio URLs (voice cover response)

meta
object

Metadata about the audio generation including all parameters used

eta
integer

Estimated time for completion in seconds (processing status)

message
string

Status message or additional information

tip
string

Additional information or tips for the user

fetch_result
string<uri>

URL to fetch the result when processing

audio_time
number

Duration of the generated audio in seconds