⚡ NEW: Flux Klein 9B — Faster inference, stunning quality · Try Now
Using the APIs
Our AI APIs
- Voice & Audio API
- POSTSong Generator
- POSTLyrics Generator
- POSTVoice Cloning
- POSTText to Speech
- POSTSpeech To Text
- POSTVoice changer
- POSTMusicGen
- POSTSound Effects (SFX)
- POSTSong Cover
- POSTCreate Dubbing
- POSTVocal Isolator
- POSTGet Uploaded Voices
- POSTFetch Queued Voice
- POSTVoice Upload
- POSTBase64 to URL
- POSTVoice Design
curl --request POST \
--url https://modelslab.com/api/v6/voice/song_generator \
--header 'Content-Type: application/json' \
--data '
{
"lyrics_generation": true,
"key": "<string>",
"prompt": "<string>",
"caption": "<string>",
"lyrics": "<string>",
"init_audio": "<string>",
"duration": 123,
"language": "ar",
"instrumental": true,
"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
}Song Generator
Generate full songs in 50+ languages by providing lyrics and a reference audio style using the ACE-Step v1.5 model.
curl --request POST \
--url https://modelslab.com/api/v6/voice/song_generator \
--header 'Content-Type: application/json' \
--data '
{
"lyrics_generation": true,
"key": "<string>",
"prompt": "<string>",
"caption": "<string>",
"lyrics": "<string>",
"init_audio": "<string>",
"duration": 123,
"language": "ar",
"instrumental": true,
"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
The Song Generator API lets you create complete, production-quality songs by combining your lyrics with a reference audio file that defines the style, mood, and instrumentation. You can also skip writing lyrics entirely and let the model generate them automatically from a prompt.Write your lyrics and style
prompt. Supply a caption describing the musical style : genre, instruments, vocal type, and mood.Configure audio and duration
init_audio to influence the style further. Set the duration between 30 and 480 seconds.Request
Make aPOST request to the endpoint below and pass the required parameters as a JSON body.
--request POST 'https://modelslab.com/api/v6/voice/song_generator' \
Body Parameters
true to auto-generate lyrics from prompt. When false, provide lyrics directly.[Verse 1], [Chorus], [Bridge]. Required if lyrics_generation is false.lyrics_generation is true."female vocal, pop, piano, slow, emotional".true to generate a vocals-free instrumental track.Example Requests
- Song duration must be between 30 and 480 seconds (0.5–8 minutes)
- If you don’t have lyrics, set
lyrics_generation: trueand provide apromptandcaptioninstead - Set
instrumental: trueto generate a vocals-free track - 50+ languages are supported : see the table below
lyrics_generation: false){
"key": "your_api_key",
"lyrics_generation": false,
"lyrics": "[Verse 1]\nYour eyes hypnotize me, make me sigh\nYour lips call to me, I can't escape\n\n[Chorus]\nTonight I'll give you everything\nIn your arms I'll stay",
"caption": "female vocal, reggaeton, deep bass, drum machine, reverb",
"duration": 120,
"webhook": null,
"track_id": null
}
lyrics_generation: true){
"key": "your_api_key",
"lyrics_generation": true,
"prompt": "A Cantopop track with layered female vocals and synth keys",
"caption": "female vocal, Cantopop, synth keys, mid-tempo, ethereal",
"duration": 180,
"webhook": null,
"track_id": null
}
Supported Languages
| Language | Code |
|---|---|
| Arabic | ar |
| Azerbaijani | az |
| Bulgarian | bg |
| Bengali | bn |
| Catalan | ca |
| Czech | cs |
| Danish | da |
| German | de |
| Greek | el |
| English | en |
| Spanish | es |
| Persian | fa |
| Finnish | fi |
| French | fr |
| Hebrew | he |
| Hindi | hi |
| Croatian | hr |
| Haitian Creole | ht |
| Hungarian | hu |
| Indonesian | id |
| Icelandic | is |
| Italian | it |
| Japanese | ja |
| Korean | ko |
| Latin | la |
| Lithuanian | lt |
| Malay | ms |
| Nepali | ne |
| Dutch | nl |
| Norwegian | no |
| Punjabi | pa |
| Polish | pl |
| Portuguese | pt |
| Romanian | ro |
| Russian | ru |
| Sanskrit | sa |
| Slovak | sk |
| Serbian | sr |
| Swedish | sv |
| Swahili | sw |
| Tamil | ta |
| Telugu | te |
| Thai | th |
| Tagalog | tl |
| Turkish | tr |
| Ukrainian | uk |
| Urdu | ur |
| Vietnamese | vi |
| Cantonese | yue |
| Chinese | zh |
Body
- Auto-generate lyrics
- Manual lyrics
Pass true to generate lyrics automatically
true API key for authentication
Topic for lyrics generation. Required if lyrics_generation is true
Caption for the song describe styles, female or male voice or loops and more.
Lyrics in LRC format (timestamp + lyrics). Required if lyrics_generation is false
URL to reference audio file to influence style
Duration of the generated song in seconds (30-480 seconds / 0.5-8 minutes)
Language for the generated song
ar, az, bg, bn, ca, cs, da, de, el, en, es, fa, fi, fr, he, hi, hr, ht, hu, id, is, it, ja, ko, la, lt, ms, ne, nl, no, pa, pl, pt, ro, ru, sa, sk, sr, sv, sw, ta, te, th, tl, tr, uk, ur, vi, yue, zh, null Whether to generate an instrumental version without vocals
URL to receive POST notification upon completion
ID for webhook identification
Response
Song generation response
Status of the voice generation
success, processing, error Time taken to generate the audio in seconds
Unique identifier for the voice generation
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)
Metadata about the audio generation including all parameters used
Estimated time for completion in seconds (processing status)
Status message or additional information
Additional information or tips for the user
URL to fetch the result when processing
Duration of the generated audio in seconds
Was this page helpful?