Mureka V9 Song API
Generate a full song from lyrics in one async task. Optional style prompt and Mureka-uploaded reference / vocal / melody IDs steer the result. Up to three songs per request, returned as mp3, wav, or flac.
Mureka V9 Song API
Use mureka-v9-song to turn written lyrics into one or more fully
produced songs. Each call is asynchronous: submit the task, poll for
completion, then fetch the rendered audio from the returned URLs.
Endpoint
POST /api/v1/audio/generationsPoll completion with:
GET /api/v1/tasks/{id}The task stays in processing until the song is rendered; final URLs
land in output.audio_urls when the status flips to completed.
Example
curl https://reapi.ai/api/v1/audio/generations \
-H "Authorization: Bearer $REAPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "mureka-v9-song",
"lyrics": "Verse 1...\nChorus...\nVerse 2...",
"prompt": "Emotional pop ballad with piano, warm strings, cinematic chorus, expressive female vocal, polished modern production",
"number_of_songs": 1,
"output_format": "mp3"
}'Parameters
| Field | Type | Required | Notes |
|---|---|---|---|
model | string | yes | Must be mureka-v9-song. |
lyrics | string | yes | Lyrics for the song. Up to 3000 characters. |
prompt | string | no | Optional style prompt — genre, mood, instrumentation, vocal tone, tempo, production feel. Up to 1024 characters. |
number_of_songs | integer | no | 1, 2, or 3. Defaults to 1. Each additional song multiplies the per-request cost. |
output_format | enum | no | mp3, wav, or flac. Defaults to mp3. |
reference_id | string | no | Optional Mureka reference-track ID for tighter style guidance. |
vocal_id | string | no | Optional Mureka vocal-reference ID. |
melody_id | string | no | Optional Mureka melody-reference ID. |
The three reference IDs are minted by Mureka's own upload system. ReAPI forwards them verbatim and does not proxy uploads — bring an ID you already have, or omit them entirely for fully generated songs.
Output
Successful tasks return one URL per generated song in
output.audio_urls. With number_of_songs: 3 the array contains three
URLs, all in the same format selected by output_format.
Pricing
Billed per generated song. Only number_of_songs affects pricing —
prompt, output_format, and the three reference IDs are free to use.
See current rates on the
Mureka V9 model page.
Tips
- Structure lyrics with clear
Verse/Chorus/Bridgeblocks for better arrangement. - Use the style prompt to pin genre, tempo, and vocal character — Mureka follows these strongly.
- Set
number_of_songs > 1when you want quick variations from the same lyrics. - Use a reference ID only when you want the model to track a specific vocal or melody — without one it composes freely from the lyrics + prompt.
- Stick with
mp3while iterating; switch towavorflacfor final mastering.