Retrieve the list of songs you have generated
September 25, 2024 (August 21, 2025)
This version of MiniMax audio has been decommissioned. Consider switching to Mureka API
Table of contents
Use hailuoai.com/music account to retrieve generated music, see Setup MiniMax for details.
https://api.useapi.net/v1/minimax/music/?…
Request Headers
Authorization: Bearer {API token}
Content-Type: application/json
API token
is required, see Setup useapi.net for details.
Query Parameters
-
account
is optional when only one account configured. However, if you have multiple accounts configured, this parameter becomes required. -
limit
is optional, specify the number of songs to return. Default 20. -
lastMusicId
is optional, specify the music id from where to start.
Responses
-
[ { "title": "<title>", "lyrics": "<lyrics>", "style": "Urban", "coverURL": "https://minimax-public-cdn.com/music/final_v3/123456789.png", "audioURL": "https://cdn.hailuoai.com/prod/2024-10-05-08/music/123456789.mp3", "status": 2, "statusLabel": "completed", "statusFinal": true, "createTime": 123456789, "duration": 45, "musicId": "user:user_id-minimax:account_id-music:music_id" }, { "title": "<title>", "lyrics": "<lyrics>", "style": "Popular", "coverURL": "https://minimax-public-cdn.com/music/final_v3/987654321.png", "audioURL": "https://cdn.hailuoai.com/prod/2024-10-05-08/music/987654321.mp3", "status": 2, "statusLabel": "completed", "statusFinal": true, "createTime": 123456789, "duration": 38, "musicId": "user:user_id-minimax:account_id-music:music_id" }, ]
-
{ "error": "<Error message>", "code": 400 }
-
{ "error": "Unauthorized", "code": 401 }
Model
Known status
values:
- 0 pending
- 1 processing
- 2 completed
- 4 moderated
{ // TypeScript, all fields are optional
title: string
lyrics: string
style: string
coverURL: string
audioURL: string
status: number
statusLabel: string
statusFinal: boolean
createTime: number
duration: number
musicId: string
}[]
Examples
-
curl "https://api.useapi.net/v1/minimax/music/?account=account" \ -H "Accept: application/json" \ -H "Authorization: Bearer …"
-
const token = "API token"; const account = "Previously configured account"; const apiUrl = `https://api.useapi.net/v1/minimax/music/?account=${account}`; const response = await fetch(apiUrl, { headers: { "Authorization": `Bearer ${token}`, }, }); const result = await response.json(); console.log("response", {response, result});
-
import requests token = "API token" account = "Previously configured account" apiUrl = f"https://api.useapi.net/v1/minimax/music/?account={account}" headers = { "Content-Type": "application/json", "Authorization" : f"Bearer {token}" } response = requests.get(apiUrl, headers=headers) print(response, response.json())