DocsICP FilingConsole
官方文档
首页

Voice management

更新时间：
复制 MD 格式
产品详情
我的收藏

Query available voices

Endpoint

Chinese mainland

In the Chinese mainland deployment mode, the endpoint and data storage are both located in the Beijing Region, and the model inference computing resources are limited to the Chinese mainland.

HTTP Request: POST https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation

Base URL for SDK calls: https://dashscope.aliyuncs.com/api/v1

Headers

Parameter

Type

Required

Description

Authorization

string

Yes

The Authorization Token is in the format Bearer <your_api_key>, and you must replace <your_api_key> with your actual API Key.

Content-Type

string

Yes

Fixed to application/json.

Request body

Query generated voices

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 (Required)

The model name must be set to MiniMax/speech-2.8-turbo.

input object (Required)

Properties

action string (Required)

The operation to perform can be set to get_voice (Get Voice).

voice_type string (Required)

The type of voices to query. Supported values include:

  • system: System voices.

  • voice_cloning: Cloned Voice. It can be queried only after it is successfully used for speech synthesis.

  • voice_generation: A voice generated by the Generated Voice interface. Not currently supported.

  • all: All of the above.

Response body

Query generated voices

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

request_id string

A unique identifier for the request.

output object

Properties

system_voiceobject[]

An array containing the predefined System Voices.

Properties

voice_idstring

The ID of the voice.

voice_namestring

The display name for the voice. This is not the ID used in API calls; use voice_id instead.

descriptionstring[]

A description of the voice.

voice_cloningobject[]

An array of your Cloned Voices.

Properties

voice_idstring

The ID of the voice.

voice_namestring

The display name for the voice. This is not the ID used in API calls; use voice_id instead.

descriptionstring[]

A description of the voice.

created_timestring

The time the voice was created, in yyyy-mm-dd format.

base_respobject

Properties

status_codeinteger

The response status code.

  • 0: The request was successful.

  • 2013: An input parameter is invalid.

For more information, see the Error Code List.

status_msgstring

A detailed message about the status.

Delete a voice

Endpoint

Chinese mainland

In the Chinese mainland deployment mode, both the endpoint and data storage are located in the Beijing Region, and model inference computing resources are limited to the Chinese mainland.

HTTP Request: POST https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation

Base URL for SDK calls: https://dashscope.aliyuncs.com/api/v1

Headers

Parameter

Type

Required

Description

Authorization

string

Yes

The Authorization Token is in the format Bearer <your_api_key>. Replace <your_api_key> with your actual API Key.

Content-Type

string

Yes

Fixed to application/json.

Request body

Delete a voice

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 (Required)

The model name. Set the value to MiniMax/speech-2.8-turbo.

input object (Required)

Properties

action string (Required)

The operation to perform is delete_voice (delete voice).

voice_type string (Required)

Set to: voice_cloning.

voice_id string (Required)

The ID of the Cloned Voice to be deleted.

Response body

Delete a voice

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

A unique identifier for the request.

output object

Properties

voice_idstring

The ID of the voice that was deleted.

created_timestring

The creation time of the deleted voice, in yyyy-mm-dd format.

base_respobject

Properties

status_codeinteger

The response status code.

  • 0: The request was successful.

  • 2013: An input parameter is invalid.

For more information, see the Error Code List.

status_msgstring

A detailed message about the status.