Create song

curl -X POST "https://mvp.tryunsora.com/api/v1/music-generations/create" \
  -H "Authorization: Bearer uns_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lyrics": "[Verse]\nNeon rain falls on the city street\nI hear your voice in the midnight heat",
    "prompt": "r&b, slow, passionate, male vocal",
    "model": "auto",
    "output_format": "mp3"
  }'

{
  "success": true,
  "generation": {
    "id": "<string>",
    "status": "<string>"
  },
  "creditsDeducted": 123,
  "creditsRemaining": 123
}

{
  "error": "<string>",
  "success": true,
  "code": "<string>",
  "message": "<string>"
}

POST

music-generations

create

curl -X POST "https://mvp.tryunsora.com/api/v1/music-generations/create" \
  -H "Authorization: Bearer uns_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lyrics": "[Verse]\nNeon rain falls on the city street\nI hear your voice in the midnight heat",
    "prompt": "r&b, slow, passionate, male vocal",
    "model": "auto",
    "output_format": "mp3"
  }'

{
  "success": true,
  "generation": {
    "id": "<string>",
    "status": "<string>"
  },
  "creditsDeducted": 123,
  "creditsRemaining": 123
}

{
  "error": "<string>",
  "success": true,
  "code": "<string>",
  "message": "<string>"
}

Creates a music generation job powered by Mureka AI on WaveSpeed. Credits are deducted when the job is queued. Poll Poll music status with the returned generation.id until status is COMPLETED or FAILED. For the dashboard UI (models, lyrics, playback, and the global player), see Music generator and Playback & player.

Headers

Header	Required	Description
`Authorization`	Yes	`Bearer uns_live_*` API key or Clerk JWT
`Idempotency-Key`	No	Max 128 chars. Replays the same response for 24h on API key requests
`Content-Type`	Yes	`application/json`

Request body

string

required

Song lyrics. Required for song models (auto, mureka-9, mureka-8, mureka-o2, mureka-7.6). Max 3000 characters.

string

required

Style prompt — genre, mood, tempo, vocal style. Max 1024 characters.

string

Model key. Default: auto (Mureka V9).

`model`	Display name	Credits	Notes
`auto`	Mureka V9 (Auto)	5	Full song with lyrics
`mureka-9`	Mureka V9	5	Full song with lyrics
`mureka-8`	Mureka V8	5	Full song with lyrics
`mureka-o2`	Mureka O2	6	Full song with lyrics
`mureka-7.6`	Mureka V7.6	4	Full song with lyrics
`mureka-7.5`	Mureka V7.5 (BGM)	4	Instrumental background music

string

Output audio format: mp3, wav, or flac. Default: mp3.

Async completion

Poll Poll music status with generation.id until status is COMPLETED or FAILED. Webhooks are not supported on the public API.

Response

{
  "success": true,
  "generation": {
    "id": "cm123abc",
    "status": "QUEUED"
  },
  "creditsDeducted": 5,
  "creditsRemaining": 95
}

Example

curl -X POST "https://mvp.tryunsora.com/api/v1/music-generations/create" \
  -H "Authorization: Bearer uns_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lyrics": "[Verse]\nNeon rain falls on the city street\nI hear your voice in the midnight heat",
    "prompt": "r&b, slow, passionate, male vocal",
    "model": "auto",
    "output_format": "mp3"
  }'

Errors

HTTP	When
`400`	Missing/invalid lyrics, prompt, model, or output format
`401`	Invalid auth
`402`	Insufficient credits
`404`	User not found
`429`	Rate limit exceeded
`500`	Server error

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

lyrics

string

Song lyrics (required for song models, up to 3000 chars)

prompt

string

Style prompt — genre, mood, vocal style (up to 1024 chars)

model

string

default:auto

Model key: auto, mureka-9, mureka-8, mureka-o2, mureka-7.6, mureka-7.5

output_format

enum<string>

default:mp3

Available options:

mp3,

wav,

flac

Response

Job queued

success

boolean

required

generation

object

required

Show child attributes

creditsDeducted

number

required

creditsRemaining

number

required

API documentation

CLI

User

Accounts

Posts

Generation status

Video generator

Image generator

Music generator

Voiceover

AI influencer

Thumbnail generator

Clipping

Uploads

Headers

Request body

Async completion

Response

Example

Errors

Authorizations

Body

Response

​Headers

​Request body

​Async completion

​Response

​Example

​Errors

Authorizations

Body

Response

Headers

Request body

Async completion

Response

Example

Errors