Skip to main content
POST
/
api
/
v2
/
generate
Music Generation
curl --request POST \
  --url https://api.example.com/api/v2/generate \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "duration": 123
}
'

​
Models

SlugProviderTierCost
musicgenReplicateStarter9 tkn
elevenlabs-musicElevenLabsBasic+58 tkn

​
Request

​
Authorization
string
required
Authorization: Bearer nb_YOUR_API_KEY
​
model
string
required
musicgen or elevenlabs-music
​
prompt
string
required
Text description of the music — genre, mood, instruments, tempo.Example: "Upbeat electronic dance track with synthesizers, 128 BPM, energetic"
​
duration
integer
default:"30"
Duration in seconds. Range: 15–120.

​
Response

{
  "id": "gen_01j9x2abc123",
  "status": "completed",
  "type": "audio",
  "model": "elevenlabs-music",
  "output_url": "https://cdn.elumenta.ru/audio/gen_01j9x2abc123.mp3",
  "duration_seconds": 30,
  "tokens_used": 58,
  "created_at": "2026-03-01T12:00:00Z"
}

​
Code Examples

import requests

response = requests.post(
    "https://elumenta.ru/api/v2/generate",
    headers={"Authorization": "Bearer nb_YOUR_API_KEY"},
    json={
        "model": "musicgen",
        "prompt": "Calm lo-fi hip hop, vinyl crackle, piano, 80 BPM, for studying",
        "duration": 30
    }
)
print(response.json()["output_url"])

​
Prompt Tips

GoalPrompt example
Background"Soft ambient background music, minimal, piano and pads"
Workout"High energy rock, electric guitar riff, 140 BPM, motivational"
Cinematic"Epic orchestral film score, rising tension, full strings and brass"
Lo-fi"Lo-fi hip hop, vinyl crackle, Rhodes piano, 75 BPM, relaxing"
Corporate"Uplifting corporate background music, light piano, positive, professional"