Generate AI Music - v1

🚀 apiv2 is live!

Soundverse’s Enterprise API has moved to apiv2.soundverse.ai — new self-serve account setup, API keys, and billing are managed at platform.soundverse.ai. This page documents the legacy api.soundverse.ai API.

Deprecated: As of 30/12/2025 this has been deprecated and will be removed soon. Please migrate to a newer version.

Generate AI Music 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

Python
cURL

  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())

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

200 OK
400 Bad Request

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

Get Started

Frequently Asked Questions

Creating with Soundverse

Exploring Soundverse

Account Management

Enterprise Platform

API Documentation

Generate AI Music - v1

🚀 apiv2 is live!

Generate AI Music from Prompt

Core Parameters

Supported Music Styles

Request Body for Prompt to Song

Code Samples

Response

Sample Output

Possible Errors :

🚀 apiv2 is live!

​Generate AI Music from Prompt

​Core Parameters

​Supported Music Styles

​Request Body for Prompt to Song

​Code Samples

​Response

​Sample Output

​Possible Errors :

Generate AI Music from Prompt

Core Parameters

Supported Music Styles

Request Body for Prompt to Song

Code Samples

Response

Sample Output

Possible Errors :