API文档

统一TTS接口文档

GET

音色列表接口

查询指定模型支持的音色列表，包括音色特征和使用建议

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

请求参数

请求头
参数名 类型 必填 说明
X-API-Key string 必需 用户API密钥，用于身份验证
路径参数
参数名 类型 必填 说明
model string 必需 TTS模型名称，必须是有效的模型名称，可通过模型列表接口获取
请求示例 
# 查询Edge TTS模型的音色列表
curl -X GET https://unifiedtts.com/api/v1/tools/voices/edge-tts \
  -H "X-API-Key: your-api-key-here"

# 查询MiniMax模型的音色列表  
curl -X GET https://unifiedtts.com/api/v1/tools/voices/speech-02-turbo \
  -H "X-API-Key: your-api-key-here"

响应说明

成功响应 (200)
参数名 类型 说明
success boolean 操作是否成功
message string 响应消息描述
timestamp number 响应时间戳（Unix时间戳，毫秒）
data array<VoiceDto> 音色选项列表
data[].voiceId string 音色的唯一标识符，用于TTS请求
data[].voiceName string 音色的显示名称
data[].language string 音色支持的语言代码
data[].gender string 音色性别：Male、Female或Unknown
data[].description string 音色的描述信息
响应示例
{
  "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)"
    }
  ]
}
重要提示

每个模型支持的音色以官方模型支持为准，本接口可能存在延迟不准确的情况。如有疑问，请参考各TTS提供商的官方文档。

登录后使用在线测试

请先登录并获取API Key，然后就可以在线测试接口了

登录