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
}

​
Request

Make a POST request to the endpoint below and pass the required parameters in the request body.
curl
--request POST 'https://modelslab.com/api/v6/voice/lyrics_generator' \
The length parameter allows you to specify whether you want short or long lyrics generated. Choose “short” for minimal lyrics or “long” for more extensive verses.
Lyrics will be generated in English language only.

​
Body

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

​
proxy_links
string<uri>[]

Array of proxy audio URLs

​
future_links
string<uri>[]

Array of future audio URLs for queued requests

​
links
string<uri>[]

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