Retrieve the list of songs you have generated

September 25, 2024 (March 17, 2025)

Table of contents

  1. Request Headers
  2. Query Parameters
  3. Responses
  4. Model
  5. Examples
  6. Try It

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
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

  • 200 OK

    [
    {
        "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"
    },
]

  • 400 Bad Request

    {
    "error": "<Error message>",
    "code": 400
}

  • 401 Unauthorized

    {
  "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())
Try It