Voice design

List voices

Returns a paginated list of voices under your account.

POST

/services/audio/tts/customization

cURL

curl --request POST \
  --url 'https://dashscope-intl.aliyuncs.com/api/v1/services/audio/tts/customization' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "qwen-voice-design",
  "input": {
    "action": "list",
    "page_index": 0,
    "page_size": 0
  }
}
'

{
  "output": {
    "page_index": 0,
    "page_size": 10,
    "total_count": 26,
    "voice_list": [
      {
        "voice": "qwen-tts-vd-announcer-voice-20251210170454-a1b2",
        "target_model": "qwen3-tts-vd-realtime-2026-01-15",
        "language": "en",
        "voice_prompt": "A composed middle-aged male announcer with a deep, rich and magnetic voice.",
        "preview_text": "Dear listeners, hello everyone. Welcome to the evening news.",
        "gmt_create": "2025-12-10 17:04:54",
        "gmt_modified": "2025-12-10 17:04:54"
      }
    ]
  },
  "usage": {},
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

Authorizations

string

header

required

DashScope API key. Get one at API key.

Body

application/json

enum<string>

required

Voice design model. Fixed to qwen-voice-design.

Available options:qwen-voice-design

Example:qwen-voice-design

object

required

Show child attributes

enum<string>

required

Operation type. Fixed to list.

Available options:list

Example:list

integer

default0

Page number (0-indexed). Range: 0–200.

Example:0

Required range:0 <= x <= 200

integer

default10

Results per page. Must be greater than 0.

Example:10

Required range:x >= 1

Response

200-application/json

object

Show child attributes

integer

Current page number.

Example:0

integer

Entries per page.

Example:10

integer

Total number of voices under the account.

Example:26

object[]

Array of voice objects.

Show child attributes

string

Voice name.

Example:qwen-tts-vd-announcer-voice-20251210170454-a1b2

string

Synthesis model bound to this voice.

Example:qwen3-tts-vd-realtime-2026-01-15

string

Language code.

Example:en

string

Voice description.

Example:A composed middle-aged male announcer with a deep, rich and magnetic voice.

string

Preview text used when the voice was created.

Example:Dear listeners, hello everyone. Welcome to the evening news.

string

Creation timestamp.

Example:2025-12-10 17:04:54

string

Last modified timestamp.

Example:2025-12-10 17:04:54

object

Usage info (empty for list operations).

string

Request ID for troubleshooting.

Example:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

cURL

curl --request POST \
  --url 'https://dashscope-intl.aliyuncs.com/api/v1/services/audio/tts/customization' \
  --header 'Authorization: Bearer <YOUR_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "qwen-voice-design",
  "input": {
    "action": "list",
    "page_index": 0,
    "page_size": 0
  }
}
'

{
  "output": {
    "page_index": 0,
    "page_size": 10,
    "total_count": 26,
    "voice_list": [
      {
        "voice": "qwen-tts-vd-announcer-voice-20251210170454-a1b2",
        "target_model": "qwen3-tts-vd-realtime-2026-01-15",
        "language": "en",
        "voice_prompt": "A composed middle-aged male announcer with a deep, rich and magnetic voice.",
        "preview_text": "Dear listeners, hello everyone. Welcome to the evening news.",
        "gmt_create": "2025-12-10 17:04:54",
        "gmt_modified": "2025-12-10 17:04:54"
      }
    ]
  },
  "usage": {},
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}