Skip to main content

​
Generate AI Song from Prompt

  • This endpoint generates songs 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⚠️ OptionalPreferred style.
audioUrlstring⚠️ OptionalURL to a reference audio file for influence.
🛈 Reference audio duration should be atleast 30s and the audioUrl should be public.

​
Request Body for Prompt to Song

{
  "prompt": "string",
  "styleOfMusic": "string",
  "audioUrl": "string"
}

​
Code Samples

  • Python
  • cURL
  import requests

  url = "https://api.soundverse.ai/v4/generate/song-from-prompt"
  headers = {
      "Authorization": "Bearer your_api_key_here",
      "Content-Type": "application/json"
  }
  payload = {
  "prompt": "string",
  "styleOfMusic": "optional",
  "audioUrl": "optional"
  }

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

​
Response

  • 200 OK
  • 400 Bad Request
{
  "messageId":"str"
  "prompt":"str",
  "albumArt":"str",
  "aiReply":"str",
  "audioData":[
    {
      "audioUrl":"str",
      "songName":"str",
      "licenses":"str"
    },
    {
      "audioUrl":"str",
      "songName":"str",
      "licenses":"str"
    }
  ]
}

​
Sample Output

{
  "messageId": "68b7079d56bb5b8b8ff8f4fb",
  "prompt": "A hopeful melody with rising strings and ambient piano, like the end of a movie when the hero finds peace.",
  "albumArt": "https://storage.soundverse.ai/soundverse-album-art/681babcdc9b9a92b09132ff5/681babcdc9b9a92b09132ff5/0ed32dce-8771-4c1a-8584-b77024c8ff9f.webp",
  "aiReply": "Your audio creation has sprouted wings and is ready to soar. Press play and let it take flight into the realm of music.",
  "audioData": [
    {
      "audioUrl": "https://storage.soundverse.ai/x-one/681babcdc9b9a92b09132ff5/681babcdc9b9a92b09132ff5/tmpzrx5d0ps.mp3",
      "songName": "Serene Horizon: A Heros Journey",
      "licenses": "Sample"
    },
    {
      "audioUrl": "https://storage.soundverse.ai/x-one/681babcdc9b9a92b09132ff5/681babcdc9b9a92b09132ff5/tmpq0ocmr8o.mp3",
      "songName": "Serene Horizon: A Heros Journey",
      "licenses": "Sample"
    }
  ]
}

​
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
lyricsstring✅ RequiredLyrics to be converted into a song.
styleOfMusicstring⚠️ Optional (Either styleOfMusic or audioUrl must be present)Preferred style.
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

  • Python
  • cURL
  import requests

  url = "https://api.soundverse.ai/v4/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

  • 200 OK
  • 400 Bad Request

    {
      "messageId":"str"
      "prompt":"str",
      "albumArt":"str",
      "aiReply":"str",
      "audioData":[
        {
          "audioUrl":"str",
          "songName":"str",
          "licenses":"str"
        }
      ]
    }

​
Sample Output

{
  "messageId": "68b7079d8ee2e214273a25e3",
  "prompt": "A hopeful melody with rising strings and ambient piano, like the end of a movie when the hero finds peace.",
  "albumArt": "https://storage.soundverse.ai/soundverse-album-art/681babcdc9b9a92b09132ff5/681babcdc9b9a92b09132ff5/0ed32dce-8771-4c1a-8584-b77024c8ff9f.webp",
  "aiReply": "Your audio creation has sprouted wings and is ready to soar. Press play and let it take flight into the realm of music.",
  "audioData": [
    {
      "audioUrl": "https://storage.soundverse.ai/x-one/681babcdc9b9a92b09132ff5/681babcdc9b9a92b09132ff5/tmpzrx5d0ps.mp3",
      "songName": "Serene Horizon: A Heros Journey",
      "licenses": "Sample"
    },
    {
      "audioUrl": "https://storage.soundverse.ai/x-one/681babcdc9b9a92b09132ff5/681babcdc9b9a92b09132ff5/tmpq0ocmr8o.mp3",
      "songName": "Serene Horizon: A Heros Journey",
      "licenses": "Sample"
    }
  ]
}

​
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.",
}
⌘I