🎢 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": "optional" ,
  "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.",
}

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