Generate Music from Text
This API allows you to generate AI-powered music based on a text description.
Choose between:
- 🎧 HD Quality →
sansaar_1 (Higher fidelity)
- ⚡ Fast Mode →
sansaar_1_lite (Quicker processing)
Core Parameters
🛈 The parameters below define the request body for this API.
| Parameter | Type | Required? | Description |
|---|
prompt | string | ✅ Required | Text description of the music. |
duration | integer | ⚠️ Optional | Track length (15s, 30s, 60s, 180s). |
model | string | ⚠️ Optional | "sansaar_1" (HQ) or "sansaar_1_lite" (Faster). |
loop | boolean | ⚠️ Optional | Whether the music should loop. |
Request Body
{
"prompt": "A futuristic electronic track with deep bass and synths.",
"duration": 15,
"model": "sansaar_1_lite",
"loop": false
}
Code Samples
import requests
url = "https://api.soundverse.ai/v1/generate/text-to-music"
headers = {
"Authorization": "Bearer your_api_key_here",
"Content-Type": "application/json"
}
payload = {
"prompt": "Compose a futuristic electronic track with cutting-edge synth sounds and pulsing beats.",
"duration": 15,
"model": "sansaar_1_lite",
"loop": false
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
import requests
url = "https://api.soundverse.ai/v1/generate/text-to-music"
headers = {
"Authorization": "Bearer your_api_key_here",
"Content-Type": "application/json"
}
payload = {
"prompt": "Compose a futuristic electronic track with cutting-edge synth sounds and pulsing beats.",
"duration": 15,
"model": "sansaar_1_lite",
"loop": false
}
response = requests.post(url, json=payload, headers=headers)
print(response.json())
curl -X POST "https://api.soundverse.ai/v1/generate/text-to-music" \
-H "Authorization: Bearer your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Compose a futuristic electronic track with cutting-edge synth sounds and pulsing beats.",
"duration": 15,
"model": "sansaar_1_lite",
"loop": false
}'
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 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.",
}
