Voice design

Query a voice

Returns details about a specific voice.

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": "query",
    "voice": "<string>"
  }
}
'

{
  "output": {
    "voice": "qwen-tts-vd-announcer-voice-20251210145409-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.",
    "gmt_create": "2025-12-10 14:54:09",
    "gmt_modified": "2025-12-10 17:47:48"
  },
  "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 query.

Available options:query

Example:query

string

required

Voice name to query. Get voice names from the List voices response.

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

Response

200-application/json

object

Show child attributes

string

Voice name.

Example:qwen-tts-vd-announcer-voice-20251210145409-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.

Example:Dear listeners, hello everyone.

string

Creation timestamp.

Example:2025-12-10 14:54:09

string

Last modified timestamp.

Example:2025-12-10 17:47:48

object

Usage info (empty for query 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": "query",
    "voice": "<string>"
  }
}
'

{
  "output": {
    "voice": "qwen-tts-vd-announcer-voice-20251210145409-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.",
    "gmt_create": "2025-12-10 14:54:09",
    "gmt_modified": "2025-12-10 17:47:48"
  },
  "usage": {},
  "request_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}