GET

Voices List API

Query the voice list supported by a specific model, including voice characteristics and usage recommendations

/api/v1/tools/voices/{model}

Request Parameters

Request Headers

Parameter Name	Type	Required	Description
X-API-Key	string	Required	User API key for authentication

Path Parameters

Parameter Name	Type	Required	Description
model	string	Required	TTS model name, must be a valid model name, can be obtained through the models list API

Request Example

# Query Edge TTS model voice list
curl -X GET https://unifiedtts.com/api/v1/tools/voices/edge-tts \
  -H "X-API-Key: your-api-key-here"

# Query MiniMax model voice list  
curl -X GET https://unifiedtts.com/api/v1/tools/voices/speech-02-turbo \
  -H "X-API-Key: your-api-key-here"

Response Description

Success Response (200)

Parameter Name	Type	Description
success	boolean	Whether the operation was successful
message	string	Response message description
timestamp	number	Response timestamp (Unix timestamp in milliseconds)
data	array<VoiceDto>	List of voice options
data[].voiceId	string	Unique identifier of the voice, used for TTS requests
data[].voiceName	string	Display name of the voice
data[].language	string	Language code supported by the voice
data[].gender	string	Voice gender: Male, Female, or Unknown
data[].description	string	Description of the voice

Response Example

{
  "success": true,
  "message": "操作成功",
  "timestamp": 1703123456789,
  "data": [
    {
      "voiceId": "zh-CN-henan-YundengNeural",
      "voiceName": "Yundeng (云登(河南))",
      "language": "zh-dialect",
      "gender": "Male",
      "description": "Chinese (Zhongyuan Mandarin Henan, Simplified)"
    },
    {
      "voiceId": "zh-CN-liaoning-XiaobeiNeural",
      "voiceName": "Xiaobei (晓北(辽宁))",
      "language": "zh",
      "gender": "Female",
      "description": "Chinese (Northeastern Mandarin, Simplified)"
    }
  ]
}

Important Notice

The voices supported by each model are subject to official model support. This interface may have delays or inaccuracies. Please refer to the official documentation of each TTS provider if you have any questions.

Login Required for Online Testing

Please log in and get an API Key first, then you can test the API online

API Documentation