Skip to main content
POST
/
v1
/
delete_voice
Delete Voice
curl --request POST \
  --url https://api.minimax.io/v1/delete_voice \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --data '{
  "voice_type": "voice_cloning",
  "voice_id": "yanshang11123"
}'
{
  "voice_id": "yanshang11123",
  "created_time": "1728962464",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}
This API is used to delete a specified voice_id. Deletions apply only to voice_id values generated through Voice Clone API and Voice Design API. ⚠️ Note: Once deleted, the voice_id cannot be reused.

Authorizations

​
Authorization
string
header
required

HTTP: Bearer Auth

Headers

​
Content-Type
enum<string>
default:application/json
required

The media type of the request body. Must be set to application/json to ensure the data is sent in JSON format.

Available options:
application/json

Body

application/json

Delete voice request parameters

​
voice_type
enum<string>
required

Accepted values:

  • voice_cloning: Cloned voice
  • voice_generation: Voice generated from text prompt

Only these two categories are supported for deletion.

Available options:
voice_cloning,
voice_generation
​
voice_id
string
required

The voice_id of the voice to be deleted.

Response

200 - application/json

Successful response

​
voice_id
string

The voice_id of the deleted voice.

​
created_time
string

The time when the voice generation request was submitted, not the first activation time. Format: yyyy-mm-dd.

​
base_resp
object