MiniMax 音色管理

查询音色

查询当前账号下可调用的全部音色 ID，涵盖系统音色、快速克隆音色、文生音色。快速复刻的音色需先正式调用一次后才可查到。

POST /v1/get_voice

请求头

参数名	类型	必填	默认值	说明
Content-Type	string	是	application/json	数据交换格式
Authorization	string	是	-	鉴权信息，格式为 Bearer <API_KEY>

请求体

参数名	类型	必填	说明
voice_type	string	是	查询的音色类型。枚举值：system（系统预定义音色）、voice_cloning（快速复刻的音色，仅在成功用于语音合成后才可查询）、voice_generation（文生音色接口生成的音色，仅在成功用于语音合成后才可查询）、all（以上全部）

请求示例

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"
  }'

成功响应（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"
  }
}

字段	类型	说明
system_voice	array	系统预定义音色列表
system_voice[].voice_id	string	音色 ID
system_voice[].voice_name	string	音色名称
system_voice[].description	array<string>	音色描述
voice_cloning	array	快速复刻音色列表
voice_cloning[].voice_id	string	音色 ID
voice_cloning[].description	array<string>	生成音色时填写的描述
voice_cloning[].created_time	string	创建时间，格式 yyyy-mm-dd
voice_generation	array	文生音色列表
voice_generation[].voice_id	string	音色 ID
voice_generation[].description	array<string>	生成音色时填写的描述
voice_generation[].created_time	string	创建时间，格式 yyyy-mm-dd
base_resp.status_code	int	状态码；具体定义见错误码
base_resp.status_msg	string	状态详情

---

删除音色

删除指定的音色 ID。支持删除音色克隆和音色生成两类音色，删除后该 voice_id 不可复用。

POST /v1/delete_voice

请求头

参数名	类型	必填	默认值	说明
Content-Type	string	是	application/json	数据交换格式
Authorization	string	是	-	鉴权信息，格式为 Bearer <API_KEY>

请求体

参数名	类型	必填	说明
voice_type	string	是	音色类型。枚举值：voice_cloning（克隆音色）、voice_generation（文生音色）
voice_id	string	是	要删除的音色 ID

请求示例

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"
  }'

成功响应（HTTP 200）

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

字段	类型	说明
voice_id	string	被删除的音色 ID
created_time	string	音色创建时间的 Unix 时间戳
base_resp.status_code	int	状态码；具体定义见错误码
base_resp.status_msg	string	状态详情