爱诗 PixVerse — 创建任务

请求参数 model string（必选）模型名称。固定填写 MiniMax/speech-2.8-turbo。 input object（必选）

属性

action string（必选）需要进行的操作，支持设置为：get_voice（获取音色）voice_type string（必选）希望查询的音色类型，支持以下取值：

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

返回参数

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：状态详情。

示例

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

返回示例

{
  "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

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 $DASHSCOPE_API_KEY`。
Content-Type	string	是	固定为 `application/json`。

请求参数

model string（必选）模型名称。固定填写 MiniMax/speech-2.8-turbo。 input object（必选）

属性

action string（必选）需要进行的操作，设置为：delete_voice（删除声音）voice_type string（必选）设置为：voice_cloning。voice_id string（必选）需要删除的音色 ID。

返回参数

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：状态详情。

示例

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": "my-cloned-voice-01"
    },
    "model": "MiniMax/speech-2.8-turbo"
  }'

返回示例

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