REST API for Mureka AI by Kunlun Tech — generate songs from lyrics, descriptions or musical styles across the Mureka V9, O2, V8 and V7.6 models, with vocal references, melody seeding, custom vocal cloning, regenerate, extend and multi-speaker speech cloning.
# Derived from the first-party useapi.net Postman collection: https://useapi.net/assets/postman/mureka-v1.json
# method: derived | no operation, path, parameter or example was invented.
openapi: 3.1.0
info:
title: Mureka API v1 by useapi.net
version: 1.0.0
description: 'Full documentation available at [useapi.net](http://useapi.net/docs/api-mureka-v1/).
**New Features:**
- V9 model (mureka-9) - now the default model
- Async job support with replyUrl webhooks
- GET /jobs and GET /jobs/<jobId> endpoints
- Browserless account setup with token + refresh_token on POST /accounts
---
**Updated:** July 14, 2026'
contact:
name: useapi.net support
email: support@useapi.net
url: https://useapi.net/docs/support
x-derived-from: https://useapi.net/assets/postman/mureka-v1.json
externalDocs:
description: mureka documentation
url: https://useapi.net/docs/api-mureka-v1
servers:
- url: https://api.useapi.net/v1/mureka
security:
- bearerAuth: []
tags:
- name: mureka
description: Mureka API v1 by useapi.net
paths:
/accounts:
get:
operationId: getAccounts
summary: accounts
description: '## [Retrieve Mureka API accounts configuration.](https://useapi.net/docs/api-mureka-v1/get-mureka-accounts)'
tags:
- mureka
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
post:
operationId: postAccounts
summary: accounts
description: '## [Configure Mureka API account](https://useapi.net/docs/api-mureka-v1/post-mureka-accounts)
Two ways to connect — send **one** body.
**Email + password (recommended):** `{ "email", "password" }`. The API stores the password and logs back in automatically
whenever Mureka ends the session — no manual re-linking. Create a dedicated Mureka account with email + password via
the guided setup page. Reports `authMode: "email"`.
**Session token:** `{ "token", "refresh_token" }` copied from Mureka at sign-in. `refresh_token` is optional but recommended
(omit it for a token-only account: ~30 days, no auto-refresh, then re-link). Reports `authMode: "token"`.'
tags:
- mureka
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
email:
type: string
password:
type: string
example:
email: you@example.com
password: your-mureka-password
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/accounts/{account}:
get:
operationId: getAccountsByAccount
summary: accounts/<account>
description: '## [Retrieve Mureka API account configuration for account](https://useapi.net/docs/api-mureka-v1/get-mureka-accounts-account)'
tags:
- mureka
parameters:
- name: account
in: path
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
delete:
operationId: deleteAccountsByAccount
summary: accounts/<account>
description: '## [Delete Mureka API account](https://useapi.net/docs/api-mureka-v1/del-mureka-accounts-account)'
tags:
- mureka
parameters:
- name: account
in: path
required: true
schema:
type: string
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties: {}
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/jobs/:
get:
operationId: getJobs
summary: jobs
description: '## [List running jobs for an account](https://useapi.net/docs/api-mureka-v1/get-mureka-jobs)'
tags:
- mureka
parameters:
- name: account
in: query
required: true
schema:
type: string
description: Optional when only one account configured. Required if multiple accounts.
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/jobs/{jobId}:
get:
operationId: getJobsByJobid
summary: jobs/<jobId>
description: '## [Get job status and results](https://useapi.net/docs/api-mureka-v1/get-mureka-jobs-jobid)'
tags:
- mureka
parameters:
- name: jobId
in: path
required: true
schema:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/profile/:
get:
operationId: getProfile
summary: profile
description: '## [Retrieve your mureka.ai account information (credits etc)](https://useapi.net/docs/api-mureka-v1/get-mureka-profile)'
tags:
- mureka
parameters:
- name: 'account '
in: query
required: true
schema:
type: string
description: Optional, when only one account configured. However, if you have multiple accounts configured, this parameter
becomes required
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
account:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/music/:
get:
operationId: getMusic
summary: music
description: '## [Retrieve generated music](https://useapi.net/docs/api-mureka-v1/get-mureka-music)'
tags:
- mureka
parameters:
- name: account
in: query
required: true
schema:
type: string
description: Optional, when only one account configured. However, if you have multiple accounts configured, this parameter
becomes required
- name: limit
in: query
required: false
schema:
type: string
description: Optional, specify the number of videos to return. Default 30
- name: last_id
in: query
required: false
schema:
type: string
description: Optional, specify the last_id from previous response to get next page
- name: expand
in: query
required: false
schema:
type: string
description: 'Optional, set to true to retrieve complete song details. Default: false'
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
account:
type: string
expand:
type: string
last_id:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/music/{song_id}:
get:
operationId: getMusicBySongid
summary: music/<song_id>
description: '## [Retrieve generated song details](https://useapi.net/docs/api-mureka-v1/get-mureka-music-song_id)'
tags:
- mureka
parameters:
- name: song_id
in: path
required: true
schema:
type: string
- name: limit
in: query
required: false
schema:
type: string
description: Optional, specify the number of videos to return. Default 30
- name: last_id
in: query
required: false
schema:
type: string
description: Optional, specify the last_id from previous response to get next page
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties: {}
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
delete:
operationId: deleteMusicBySongid
summary: music/<song_id>
description: '## [Delete generated song](https://useapi.net/docs/api-mureka-v1/del-mureka-music-song_id)'
tags:
- mureka
parameters:
- name: song_id
in: path
required: true
schema:
type: string
- name: limit
in: query
required: false
schema:
type: string
description: Optional, specify the number of videos to return. Default 30
- name: last_id
in: query
required: false
schema:
type: string
description: Optional, specify the last_id from previous response to get next page
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties: {}
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/music/create:
post:
operationId: postMusicCreate
summary: music/create
description: '## [Create a music using AI-generated lyrics](https://useapi.net/docs/api-mureka-v1/post-mureka-music-create)'
tags:
- mureka
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
prompt:
type: string
account:
type: string
model:
type: string
async:
type: string
replyUrl:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/music/create-advanced:
post:
operationId: postMusicCreateAdvanced
summary: music/create-advanced
description: '## [Create a music using custom lyrics, styles, vocals and reference song](https://useapi.net/docs/api-mureka-v1/post-mureka-music-create-advanced)'
tags:
- mureka
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
lyrics:
type: string
account:
type: string
title:
type: string
desc:
type: string
ref_id:
type: string
vocal_id:
type: string
motif_id:
type: string
model:
type: string
async:
type: string
replyUrl:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/music/create-instrumental:
post:
operationId: postMusicCreateInstrumental
summary: music/create-instrumental
description: '## [Create a instrumental music](https://useapi.net/docs/api-mureka-v1/post-mureka-music-create-instrumental)'
tags:
- mureka
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
prompt:
type: string
account:
type: string
model:
type: string
ref_id:
type: string
title:
type: string
async:
type: string
replyUrl:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/music/extend:
post:
operationId: postMusicExtend
summary: music/extend
description: '## [Extend song](https://useapi.net/docs/api-mureka-v1/post-mureka-music-extend)'
tags:
- mureka
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
song_id:
type: string
lyrics:
type: string
async:
type: string
replyUrl:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/music/regenerate:
post:
operationId: postMusicRegenerate
summary: music/regenerate
description: '## [Regenerate song](https://useapi.net/docs/api-mureka-v1/post-mureka-music-regenerate)'
tags:
- mureka
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
song_id:
type: string
start_milliseconds:
type: string
async:
type: string
replyUrl:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/music/video-generate:
post:
operationId: postMusicVideoGenerate
summary: music/video-generate
description: '## [Create an AI-generated video for your song](https://useapi.net/docs/api-mureka-v1/post-mureka-music-video-generate)'
tags:
- mureka
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
song_id:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/music/lyrics-generate:
post:
operationId: postMusicLyricsGenerate
summary: music/lyrics-generate
description: '## [AI-generated lyrics from your prompt](https://useapi.net/docs/api-mureka-v1/post-mureka-music-lyrics-generate)'
tags:
- mureka
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
prompt:
type: string
account:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/music/download:
post:
operationId: postMusicDownload
summary: music/download
description: '## [Download song instrumentals&stems and license](https://useapi.net/docs/api-mureka-v1/post-mureka-music-download)'
tags:
- mureka
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
song_id:
type: string
type:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/music/vocals/:
get:
operationId: getMusicVocals
summary: music/vocals
description: '## [Retrieve a list of vocal samples including the ones you uploaded](https://useapi.net/docs/api-mureka-v1/get-mureka-music-vocals)'
tags:
- mureka
parameters:
- name: account
in: query
required: true
schema:
type: string
description: Optional, when only one account configured. However, if you have multiple accounts configured, this parameter
becomes required
- name: limit
in: query
required: false
schema:
type: string
description: Optional, specify the number of videos to return. Default 30
- name: last_id
in: query
required: false
schema:
type: string
description: Optional, specify the last_id from previous response to get next page
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
account:
type: string
last_id:
type: string
mine:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/music/refs/:
get:
operationId: getMusicRefs
summary: music/refs
description: '## [Retrieve songs for reference](https://useapi.net/docs/api-mureka-v1/get-mureka-music-refs)'
tags:
- mureka
parameters:
- name: account
in: query
required: true
schema:
type: string
description: Optional, when only one account configured. However, if you have multiple accounts configured, this parameter
becomes required
- name: limit
in: query
required: false
schema:
type: string
description: Optional, specify the number of videos to return. Default 30
- name: last_id
in: query
required: false
schema:
type: string
description: Optional, specify the last_id from previous response to get next page
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
account:
type: string
last_id:
type: string
mood:
type: string
genre:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/music/moods-and-genres/:
get:
operationId: getMusicMoodsAndGenres
summary: music/moods-and-genres
description: '## [Retrieve moods and genres](https://useapi.net/docs/api-mureka-v1/get-mureka-music-moods-and-genres)'
tags:
- mureka
parameters:
- name: account
in: query
required: true
schema:
type: string
description: Optional, when only one account configured. However, if you have multiple accounts configured, this parameter
becomes required
- name: limit
in: query
required: false
schema:
type: string
description: Optional, specify the number of videos to return. Default 30
- name: last_id
in: query
required: false
schema:
type: string
description: Optional, specify the last_id from previous response to get next page
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
account:
type: string
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/files/:
get:
operationId: getFiles
summary: files
description: '## [Retrieve your reference tracks](https://useapi.net/docs/api-mureka-v1/get-mureka-files)'
tags:
- mureka
parameters:
- name: account
in: query
required: true
schema:
type: string
description: Optional, when only one account configured. However, if you have multiple accounts configured, this parameter
becomes required
- name: last_id
in: query
required: false
schema:
type: string
description: Optional, use it to retrieve the next page of data
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties: {}
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
post:
operationId: postFiles
summary: files • use Body » binary to upload .mp3
description: '## [Upload mp3 audio track to your music collection](https://useapi.net/docs/api-mureka-v1/post-mureka-files)'
tags:
- mureka
parameters:
- name: account
in: query
required: true
schema:
type: string
description: Optional, when only one account configured. However, if you have multiple accounts configured, this parameter
becomes required
- name: title
in: query
required: true
schema:
type: string
description: Required
- name: genre
in: query
required: true
schema:
type: string
description: Required, provide the genre of your track. See supported values using GET /music/moods-and-genres
- name: mood
in: query
required: true
schema:
type: string
description: Required, provide the mood of your track. See supported values using GET /music/moods-and-genres
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties: {}
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
delete:
operationId: deleteFiles
summary: files
description: '## [Delete track](https://useapi.net/docs/api-mureka-v1/del-mureka-files)'
tags:
- mureka
parameters:
- name: account
in: query
required: true
schema:
type: string
description: Optional, when only one account configured. However, if you have multiple accounts configured, this parameter
becomes required
- name: id
in: query
required: true
schema:
type: string
description: Required, to see full list of uploaded tracks use GET /files.
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties: {}
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/files/youtube/:
get:
operationId: getFilesYoutube
summary: files/youtube
description: '## [Retrieve soundtrack from YouTube url](https://useapi.net/docs/api-mureka-v1/get-mureka-files-youtube)'
tags:
- mureka
parameters:
- name: account
in: query
required: true
schema:
type: string
description: Optional, when only one account configured. However, if you have multiple accounts configured, this parameter
becomes required
- name: url
in: query
required: true
schema:
type: string
description: Required, provide the YouTube url link for which you want to retrieve the soundtrack.
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties: {}
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/files/motif/:
post:
operationId: postFilesMotif
summary: files/motif • use Body » binary to upload .mp3
description: '## [Upload mp3 melody (motif) track](https://useapi.net/docs/api-mureka-v1/post-mureka-files-motif)'
tags:
- mureka
parameters:
- name: account
in: query
required: true
schema:
type: string
description: Optional, when only one account configured. However, if you have multiple accounts configured, this parameter
becomes required
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties: {}
responses:
'200':
description: Success
content:
application/json:
schema:
type: object
'400':
description: Bad Request — invalid or missing parameter
'401':
description: Unauthorized — invalid useapi.net API token
'429':
description: Too Many Requests — see the Retry-After header
/files/vocal/:
post:
operationId: postFilesVocal
summary: files/vocal • use Body » binary to upload .mp3
description: '## [Upload mp3 vocal](https://useapi.net/docs/api-mureka-v1/post-mureka-files-vocal)'
tags:
-
# --- truncated at 32 KB (42 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/useapi/refs/heads/main/openapi/useapi-mureka-v1-openapi.yml