Mureka Song Generator

mureka-song-generator

Mureka Song Generator generates songs from lyrics, text prompts, or reference audio controls.

Endpoints

POST /v1/queue/mureka-song-generator # Create task

GET /v1/queue/mureka-song-generator/requests/{request_id}/status # Query status

GET /v1/queue/mureka-song-generator/requests/{request_id}/response # Get result

PUT /v1/queue/mureka-song-generator/requests/{request_id}/cancel # Cancel task

Request parameters

curl --location "https://odirouter.ai/model/v1/queue/mureka-song-generator" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "lyrics": "[Verse]\nThe sea breeze crosses the shoreline\nWe sing our story one more time",
    "prompt": "warm pop ballad, clean vocal, emotional chorus",
    "n": 1
  }'

lyrics string required

Lyrics used to generate the song, up to 3000 characters.

n int

Number of songs generated per request. Billing is based on the generated song count.

A single generated song may return multiple output files, such as MP3, WAV, and FLAC. These files are alternate formats for the same song, not extra songs.

Default: 2

Maximum: 3

prompt string

Text prompt used to control music generation, up to 1024 characters. It can be used alone or combined with vocal_id.

reference_id string

Controls generation with reference music. Obtained after uploading through the files/upload API with the reference purpose. It can be used alone or combined as reference_id + vocal_id.

vocal_id string

Controls music generation with a specified vocal. Obtained after uploading through the files/upload API with the vocal purpose. It can be used alone, or combined as vocal_id + reference_id or vocal_id + prompt.

melody_id string

Controls music generation with melody inspiration. Obtained after uploading through the files/upload API with the melody purpose. This option cannot be combined with other control options.

stream bool

When set to true, task status includes a streaming stage. During this stage, use stream_url to play the generated song while it is being generated.

Response parameters

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://odirouter.ai/model/v1/queue/mureka-song-generator/requests/mmsu_01hxyz.../response",
  "status_url": "https://odirouter.ai/model/v1/queue/mureka-song-generator/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://odirouter.ai/model/v1/queue/mureka-song-generator/requests/mmsu_01hxyz.../cancel",
  "queue_position": 0
}

Field	Type	Description
`request_id`	string	Task ID used for all follow-up operations.
`response_url`	string	URL for retrieving the final result.
`status_url`	string	URL for querying task status.
`cancel_url`	string	URL for canceling the task.
`queue_position`	int	Queue position.

Follow-up operations

Query status

Get result

Cancel task

Error handling