声音管理-大模型服务平台百炼(Model Studio)-阿里云帮助中心

查询可用音色 ID

URL

中国内地

在中国内地部署模式下，接入点与数据存储均位于北京地域，模型推理计算资源仅限于中国内地。

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`。

请求

查询已生成的音色

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

model string （必选）

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

input object （必选）

属性

action string （必选）

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

voice_type string （必选）

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

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

返回体	查询已生成的音色 `{ "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" }`
request_id `string` 本次调用的唯一标识符。
output `object` 属性 system_voice`object` 包含系统预定义的音色。属性 voice_id`string` 音色 ID。 voice_name`string` 音色名称，非调用的音色 ID。 description`string[]` 音色描述。 voice_cloning`object` 包含音色快速复刻的音色数据。属性 voice_id`string` 音色 ID。 voice_name`string` 音色名称，非调用的音色 ID。 description`string[]` 音色描述。 created_time`string` 创建时间，格式 yyyy-mm-dd。 base_resp`object` 属性 status_code`integer` 状态码。 `0`: 请求结果正常 `2013`: 输入参数信息不正常更多内容可查看错误码查询列表了解详情。 status_msg`string` 状态详情。

删除音色

URL

中国内地

在中国内地部署模式下，接入点与数据存储均位于北京地域，模型推理计算资源仅限于中国内地。

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`。

请求体

删除

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

model string （必选）

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

input object （必选）

属性

action string （必选）

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

voice_type string （必选）

设置为：voice_cloning。

voice_id string （必选）

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

返回体	删除 `{ "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" }`
request_id `string` 本次调用的唯一标识符。
output `object` 属性 voice_id`string` 被删除音色 ID。 created_time`string` 被删除音色的创建时间，格式 yyyy-mm-dd。 base_resp`object` 属性 status_code`integer` 状态码。 `0`: 请求结果正常 `2013`: 输入参数信息不正常更多内容可查看错误码查询列表了解详情。 status_msg`string` 状态详情。

查询可用音色 ID

URL

中国内地

Headers

请求

查询已生成的音色

返回体

查询已生成的音色

删除音色

URL

中国内地

Headers

请求体

删除

返回体

删除