πΆ Generate AI Song from Prompt
- This endpoint generates music from a text-based prompt using AI models.
Core Parameters
π The parameters below define the request body for this API.
Parameter | Type | Required? | Description |
---|
prompt | string | β
Required | Text description of the music. |
styleOfMusic | string | β
Required | Preferred style. Select one from supported styles listed below. |
audioUrl | string | β οΈ Optional | URL to a reference audio file for influence. |
Supported Music Styles
The styleOfMusic
parameter must be one of the following values:
- Pop
- Hip Hop
- Rap
- Rock
- EDM
- Latin
- Reggaeton
- K-Pop
- RnB
- Country
- Dance
- House
- Bollywood
- Afrobeat
- Afropop
- Dancehall
- Deep House
- Electronic
- Future Bass
- Trap
- Pop-Trap
- Dubstep
- Synthpop
- Synthwave
- Techno
- Progressive-Metal
- Alt-Rock
- Alt-Metal
- Nu-Metal
- Metal
- Jazz
- Blues
- Soul
- Funk
- Singer-Songwriter
- Folk
- Cloud-Rap
- Lofi
- Chillout
- Downtempo
- Meditative
- New-Age
- Western-Classical
- Classical
- Opera
- Piano
- Spoken-Word
- Gospel
- Brazilian-Music
- Bossa-Nova
- Salsa
- Bachata
- Country-Blues
- Future-Rave
- Electrostep
- Dub
- Disco
- Shoegaze
- Bit-Beat
- Indian Electronic
- African
- 80s
- Acoustic
- Melodic
Request Body for Prompt to Song
{
"prompt": "string",
"styleOfMusic": "string",
"audioUrl": "string"
}
Code Samples
import requests
url = "https://api.soundverse.ai/v1/generate/song-from-prompt"
headers = {
"Authorization": "Bearer your_api_key_here",
"Content-Type": "application/json"
}
payload = {
"prompt": "string",
"StyleOfMusic": "optional" ,
"audioUrl": "string"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
import requests
url = "https://api.soundverse.ai/v1/generate/song-from-prompt"
headers = {
"Authorization": "Bearer your_api_key_here",
"Content-Type": "application/json"
}
payload = {
"prompt": "string",
"StyleOfMusic": "optional" ,
"audioUrl": "string"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
curl -X POST "https://api.soundverse.ai/v1/generate/song-from-prompt" \
-H "Authorization: Bearer your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"prompt": "string",
"styleOfMusic": "string",
"audioUrl": "string"
}'
Response
{
"prompt":"str",
"albumArt":"str",
"aiReply":"str",
"audioData":[
{
"audioUrl":"str",
"songName":"str",
"licenses":"str"
}
]
}
{
"prompt":"str",
"albumArt":"str",
"aiReply":"str",
"audioData":[
{
"audioUrl":"str",
"songName":"str",
"licenses":"str"
}
]
}
Sample Output
{
"prompt":"A hopeful melody with rising strings and ambient piano, like the end of a movie when the hero finds peace.",
"albumArt":"https://storage.googleapis.com/soundverse-album-art/67b9ca2f20e711017fc1b6c5/67b9ca2f20e711017fc1b6c5/20250413130229_00000_album_cover_art_for_A_hopeful_melody_with_rising_strings_and_ambient_piano_like_the_end_of_a_movie_when_the_hero_finds_peace.png",
"aiReply":"Your audio jewel is polished and gleaming, a testament to your artistic prowess. Unleash its melodies and watch the world listen in awe.",
"audioData":[
{
"audioUrl":"https://storage.googleapis.com/x-one/67b9ca2f20e711017fc1b6c5/67b9ca2f20e711017fc1b6c5/xone20250413130323ltyxhk5r.wav",
"songName":"A hopeful melody with ris...",
"licenses":"Sync"
}
]
}
Possible Errors :
- If Rate Limits have been passed for User.
{
"success": False,
"message": "Rate limits have been passed for the user.",
}
- If NSFW words are detected
{
"success": False,
"message": "NSFW words detected. Please try again with a different prompt.",
}
- If Artist name is detected
{
"success": False,
"message": "Artist name detected. Please try again with a different prompt.",
}
π΅ Generate AI Song from Lyrics
This endpoint generates music from provided lyrics using AI models.
Core Parameters
π The parameters below define the request body for this API.
Parameter | Type | Required? | Description |
---|
styleOfMusic | string | β οΈ Optional (Either styleOfMusic or audioUrl must be present) | Preferred style. Select one from supported styles listed above. |
lyrics | string | β
Required | Lyrics to be converted into a song. |
audioUrl | string | β οΈ Optional (Either styleOfMusic or audioUrl must be present) | URL to a reference audio file for influence. |
Request Body for Prompt to Song
{
"styleOfMusic": "string",
"lyrics": "string",
"audioUrl": "string"
}
Code Samples
import requests
url = "https://api.soundverse.ai/v1/generate/song-from-lyrics"
headers = {
"Authorization": "Bearer your_api_key_here",
"Content-Type": "application/json"
}
payload = {
"styleOfMusic": "string",
"lyrics": "string",
"audioUrl": "string"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
import requests
url = "https://api.soundverse.ai/v1/generate/song-from-lyrics"
headers = {
"Authorization": "Bearer your_api_key_here",
"Content-Type": "application/json"
}
payload = {
"styleOfMusic": "string",
"lyrics": "string",
"audioUrl": "string"
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
curl -X POST "https://api.soundverse.ai/v1/generate/song-from-lyrics" \
-H "Authorization: Bearer your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"styleOfMusic": "string",
"lyrics": "string",
"audioUrl": "string"
}'
Response
{
"prompt":"str",
"albumArt":"str",
"aiReply":"str",
"audioData":[
{
"audioUrl":"str",
"songName":"str",
"licenses":"str"
}
]
}
{
"prompt":"str",
"albumArt":"str",
"aiReply":"str",
"audioData":[
{
"audioUrl":"str",
"songName":"str",
"licenses":"str"
}
]
}
{
βDetailβ: βstrβ
}
Sample Output
{
"prompt":"A hopeful melody with rising strings and ambient piano, like the end of a movie when the hero finds peace.",
"albumArt":"https://storage.googleapis.com/soundverse-album-art/67b9ca2f20e711017fc1b6c5/67b9ca2f20e711017fc1b6c5/20250413130229_00000_album_cover_art_for_A_hopeful_melody_with_rising_strings_and_ambient_piano_like_the_end_of_a_movie_when_the_hero_finds_peace.png",
"aiReply":"Your audio jewel is polished and gleaming, a testament to your artistic prowess. Unleash its melodies and watch the world listen in awe.",
"audioData":[
{
"audioUrl":"https://storage.googleapis.com/x-one/67b9ca2f20e711017fc1b6c5/67b9ca2f20e711017fc1b6c5/xone20250413130323ltyxhk5r.wav",
"songName":"A hopeful melody with ris...",
"licenses":"Sync"
}
]
}
Possible Errors :
- If Rate Limits have been passed for User.
{
"success": False,
"message": "Rate limits have been passed for the user.",
}
- If NSFW words are detected
{
"success": False,
"message": "NSFW words detected. Please try again with a different prompt.",
}
- If Artist name is detected
{
"success": False,
"message": "Artist name detected. Please try again with a different prompt.",
}