声音管理-阿里云帮助中心

查询可用音色 ID

URL

中国内地

服务部署范围为中国内地时，模型推理计算资源仅限于中国内地；静态数据存储于您所选的地域。该部署范围支持的地域：华北2（北京）。

HTTP请求地址：POST https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation

SDK调用配置的base_url：https://dashscope.aliyuncs.com/api/v1

Headers

参数	类型	是否必选	说明
Authorization	string	是	鉴权令牌，格式为`Bearer <your_api_key>`，使用时，将“`<your_api_key>`”替换为实际的API Key。
Content-Type	string	是	固定为`application/json`。

请求

modelstring（必选）

模型名称。固定填写MiniMax/speech-2.8-turbo。

inputobject（必选）

属性

actionstring（必选）

需要进行的操作，支持设置为：get_voice（获取音色）

voice_typestring（必选）

希望查询音色类型，支持以下取值：

system: 系统音色。
voice_cloning: 复刻的音色，仅在成功用于语音合成后才可查询。
voice_generation: 文生音色接口生成的音色，暂不支持。
all: 以上全部。

查询已生成的音色

curl -X POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
  -H "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
  -H 'Content-Type: application/json; charset=utf-8' \
  -d '{
    "input": {
      "action": "get_voice",
      "voice_type": "all"
    },
    "model": "MiniMax/speech-2.8-turbo"
  }'

返回体

request_idstring

本次调用的唯一标识符。

outputobject

属性

system_voiceobject

包含系统预定义的音色。

属性

voice_idstring

音色 ID。

voice_namestring

音色名称，非调用的音色 ID。

descriptionstring[]

音色描述。

voice_cloningobject

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

属性

voice_idstring

音色 ID。

voice_namestring

音色名称，非调用的音色 ID。

descriptionstring[]

音色描述。

created_timestring

创建时间，格式 yyyy-mm-dd。

base_respobject

属性

status_codeinteger

状态码。

0: 请求结果正常
2013: 输入参数信息不正常

更多内容可查看 错误码查询列表 了解详情。

status_msgstring

状态详情。

查询已生成的音色

{
    "output": {
        "base_resp": {
            "status_code": 0,
            "status_msg": "success"
        },
        "system_voice": [
            {
                "created_time": "1970-01-01",
                "description": [],
                "voice_id": "male-qn-qingse",
                "voice_name": "青涩青年音色"
            },
            ...
        ]
    },
    "request_id": "6cd17383-fc97-9445-adad-e4deb16716af"
}

删除音色

URL

中国内地

服务部署范围为中国内地时，模型推理计算资源仅限于中国内地；静态数据存储于您所选的地域。该部署范围支持的地域：华北2（北京）。

HTTP请求地址：POST https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation

SDK调用配置的base_url：https://dashscope.aliyuncs.com/api/v1

Headers

参数	类型	是否必选	说明
Authorization	string	是	鉴权令牌，格式为`Bearer <your_api_key>`，使用时，将“`<your_api_key>`”替换为实际的API Key。
Content-Type	string	是	固定为`application/json`。

请求体

modelstring（必选）

模型名称。固定填写MiniMax/speech-2.8-turbo。

inputobject（必选）

属性

actionstring（必选）

需要进行的操作，设置为：delete_voice（删除声音）

voice_typestring（必选）

设置为：voice_cloning。

voice_idstring（必选）

设置的需要删除的音色 ID。

删除

curl -X POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
  -H "Authorization: Bearer ${DASHSCOPE_API_KEY}" \
  -H 'Content-Type: application/json; charset=utf-8' \
  -d '{
    "input": {
      "action": "delete_voice",
      "voice_type": "voice_cloning",
      "voice_id": "bailian-test-voice-22"
    },
    "model": "MiniMax/speech-2.8-turbo"
  }'

返回体

request_idstring

本次调用的唯一标识符。

outputobject

属性

voice_idstring

被删除音色 ID。

created_timestring

被删除音色的创建时间，格式 yyyy-mm-dd。

base_respobject

属性

status_codeinteger

状态码。

0: 请求结果正常
2013: 输入参数信息不正常

更多内容可查看 错误码查询列表 了解详情。

status_msgstring

状态详情。

删除

{
    "output": {
        "base_resp": {
            "status_code": 0,
            "status_msg": "success"
        },
        "created_time": "2026-03-20",
        "voice_id": "bailian-test-voice-21"
    },
    "request_id": "045a4858-c9c4-942d-9fab-57e97a6305c3"
}