跳转到主要内容
POST
/
v1
/
get_voice
Get Voice
curl --request POST \
  --url https://api.minimaxi.com/v1/get_voice \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --data '{
  "voice_type": "all"
}'
{
  "system_voice": [
    {
      "voice_id": "Chinese (Mandarin)_Reliable_Executive",
      "description": [
        "一位沉稳可靠的中年男性高管声音,标准普通话,传递出值得信赖的感觉。"
      ],
      "voice_name": "沉稳高管",
      "created_time": "1970-01-01"
    },
    {
      "voice_id": "Chinese (Mandarin)_News_Anchor",
      "description": [
        "一位专业、播音腔的中年女性新闻主播,标准普通话。"
      ],
      "voice_name": "新闻女声",
      "created_time": "1970-01-01"
    }
  ],
  "voice_cloning": [
    {
      "voice_id": "test12345",
      "description": [],
      "created_time": "2025-08-20"
    },
    {
      "voice_id": "test12346",
      "description": [],
      "created_time": "2025-08-21"
    }
  ],
  "voice_generation": [
    {
      "voice_id": "ttv-voice-2025082011321125-2uEN0X1S",
      "description": [],
      "created_time": "2025-08-20"
    },
    {
      "voice_id": "ttv-voice-2025082014225025-ZCQt0U0k",
      "description": [],
      "created_time": "2025-08-20"
    }
  ],
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}
该 API 支持查询当前账号下可调用的全部音色 ID(voice_id)。 包括系统音色、快速克隆音色、文生音色接口生成的音色、音乐生成接口的人声音色以及伴奏音色。

Authorizations

Authorization
string
header
required

HTTP: Bearer Auth

  • Security Scheme Type: http
  • HTTP Authorization Scheme: Bearer API_key,用于验证账户信息,可在 账户管理>接口密钥 中查看。

Headers

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

请求体的媒介类型,请设置为 application/json,确保请求数据的格式为 JSON

Available options:
application/json

Body

application/json
voice_type
enum<string>
required

希望查询音色类型,支持以下取值:

  • system: 系统音色
  • voice_cloning: 快速复刻的音色,仅在成功用于语音合成后才可查询
  • voice_generation: 文生音色接口生成的音色,仅在成功用于语音合成后才可查询
  • all: 以上全部
Available options:
system,
voice_cloning,
voice_generation,
all

Response

200 - application/json
system_voice
object[]

包含系统预定义的音色。

voice_cloning
object[]

包含音色快速复刻的音色数据

voice_generation
object[]

包含音色生成接口产生的音色数据

base_resp
object

本次请求的状态码和详情

I