​
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.

ParameterTypeRequired?Description
promptstring✅ RequiredText description of the music.
styleOfMusicstring✅ RequiredPreferred style. Select one from supported styles listed below.
audioUrlstring⚠️ OptionalURL 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": "string",
  "audioUrl": "optional"
  }

  response = requests.post(url, json=payload, headers=headers)
  print(response.json())

​
Response

{
  "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.

ParameterTypeRequired?Description
styleOfMusicstring⚠️ Optional (Either styleOfMusic or audioUrl must be present)Preferred style. Select one from supported styles listed above.
lyricsstring✅ RequiredLyrics to be converted into a song.
audioUrlstring⚠️ 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())

​
Response


    {
      "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.",
}