MiniMax Voice Management

Query Voices

Query all voice IDs available under the current account, including system voices, instant clone voices, and text-to-voice voices. Voices created via instant cloning must be formally called once before they become queryable.

POST /v1/get_voice

Request Headers

Parameter	Type	Required	Default	Description
Content-Type	string	Yes	application/json	Data exchange format
Authorization	string	Yes	-	Authentication info, format is Bearer <API_KEY>

Request Body

Parameter	Type	Required	Description
voice_type	string	Yes	The voice type to query. Enumerated values: system (system predefined voices), voice_cloning (instant clone voices, only queryable after successfully used for speech synthesis), voice_generation (voices generated by the text-to-voice interface, only queryable after successfully used for speech synthesis), all (all of the above)

Request Example

curl --request POST \
  --url https://neolink.com/minimax/v1/get_voice \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "voice_type": "all"
  }'

Successful Response (HTTP 200)

{
  "system_voice": [
    {
      "voice_id": "Chinese (Mandarin)_Reliable_Executive",
      "voice_name": "沉稳高管",
      "description": ["一位沉稳可靠的中年男性高管声音，标准普通话，传递出值得信赖的感觉。"],
      "created_time": "1970-01-01"
    }
  ],
  "voice_cloning": [
    {
      "voice_id": "test12345",
      "description": [],
      "created_time": "2025-08-20"
    }
  ],
  "voice_generation": [
    {
      "voice_id": "ttv-voice-2025082011321125-2uEN0X1S",
      "description": [],
      "created_time": "2025-08-20"
    }
  ],
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

Field	Type	Description
system_voice	array	List of system predefined voices
system_voice[].voice_id	string	Voice ID
system_voice[].voice_name	string	Voice name
system_voice[].description	array<string>	Voice description
voice_cloning	array	List of instant clone voices
voice_cloning[].voice_id	string	Voice ID
voice_cloning[].description	array<string>	Description filled in when generating the voice
voice_cloning[].created_time	string	Creation time, format yyyy-mm-dd
voice_generation	array	List of text-to-voice voices
voice_generation[].voice_id	string	Voice ID
voice_generation[].description	array<string>	Description filled in when generating the voice
voice_generation[].created_time	string	Creation time, format yyyy-mm-dd
base_resp.status_code	int	Status code; see the error codes for specific definitions
base_resp.status_msg	string	Status details

---

Delete Voice

Delete the specified voice ID. Supports deleting both voice clone and voice generation voices. After deletion, the voice_id cannot be reused.

POST /v1/delete_voice

Request Headers

Parameter	Type	Required	Default	Description
Content-Type	string	Yes	application/json	Data exchange format
Authorization	string	Yes	-	Authentication info, format is Bearer <API_KEY>

Request Body

Parameter	Type	Required	Description
voice_type	string	Yes	Voice type. Enumerated values: voice_cloning (clone voice), voice_generation (text-to-voice voice)
voice_id	string	Yes	The voice ID to delete

Request Example

curl --request POST \
  --url https://neolink.com/minimax/v1/delete_voice \
  --header 'Authorization: Bearer <API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
    "voice_type": "voice_cloning",
    "voice_id": "yanshang11123"
  }'

Successful Response (HTTP 200)

{
  "voice_id": "yanshang11123",
  "created_time": "1728962464",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

Field	Type	Description
voice_id	string	The deleted voice ID
created_time	string	Unix timestamp of the voice creation time
base_resp.status_code	int	Status code; see the error codes for specific definitions
base_resp.status_msg	string	Status details