Retrieve the list of text-to-speech audio clips you have generated

December 23, 2024 (August 24, 2026)

Table of contents

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

This endpoint will return audio clips generated by

https://api.useapi.net/v1/minimax/speech/?…

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.

  • page and page_size are optional. Use them to retrieve the next page of data when the returned has_more field is true.
    Default page_size is 100.

Responses

  • 200 OK

    {
    "audio_list": [
        {
            "audio_id": "user:user_id-minimax:account_id-audio:audio_id",
            "audio_review": 0,
            "user_id": "123456789012345678",
            "audio_title": "<Audio title>",
            "audio_url": "https://cdn.hailuoai.video/...mp3",
            "update_time": 1122334455780
        },
        {
            "audio_id": "user:user_id-minimax:account_id-audio:audio_id",
            "audio_review": 0,
            "user_id": "123456789012345678",
            "audio_title": "Audio title",
            "audio_url": "https://cdn.hailuoai.video/...mp3",
            "update_time": 1122334455779
        }
    ],
    "total": 2025,
    "has_more": true
}

  • 400 Bad Request

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

  • 401 Unauthorized

    {
  "error": "Unauthorized",
  "code": 401
}

  • 596 Account Error

    {
  "error": "Your minimax account has pending error. Please address this issue at https://useapi.net/docs/api-minimax-v1/post-minimax-accounts-account before making any new API calls.",
  "code": 596
}
Model 
{   // TypeScript, all fields are optional
    audio_list: {
        audio_id: string
        audio_review: number
        user_id: string    // The MiniMax account id
        audio_title: string
        audio_url: string
        update_time: number
        text: string
        voice_name: string
        status: number
        async: number
        has_srt: boolean   // Word timings are available for this recording
        has_wav: boolean   // A WAV rendition exists alongside the MP3
    }[]
    total: number
    has_more: boolean
}
Examples 
  • curl "https://api.useapi.net/v1/minimax/speech/?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/speech/?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/speech/?account={account}"
headers = {
    "Content-Type": "application/json", 
    "Authorization" : f"Bearer {token}"
}
response = requests.get(apiUrl, headers=headers)
print(response, response.json())
Try It