跳转到主要内容
开始创作
开发文档

获取音色列表

分页获取平台已启用的 TTS 音色,支持按名称、语言、voiceId、提供方组合筛选。返回 id(数据库主键,用于套餐配置)、voice_id、language(语言,如 中文、English)等字段。JWT 或 App-Secret 鉴权时,有 tenant 上下文则额外返回 purchased(是否已开通)字段。

分页获取平台已启用的 TTS 音色,支持按名称、语言、voiceId、提供方组合筛选。返回 id(数据库主键,用于套餐配置)、voice_id、language(语言,如 中文、English)等字段。JWT 或 App-Secret 鉴权时,有 tenant 上下文则额外返回 purchased(是否已开通)字段。

POST /openapi/v1/tts/list

请求参数

参数

类型

请求示例

{
  "page": 1,
  "pageSize": 20,
  "voiceId": "Chinese (Mandarin)_BashfulGirl"
}

响应示例

{
  "code": 0,
  "msg": "ok",
  "data": {
    "list": [
      {
        "id": 1,
        "voice_id": "voice_001",
        "label": "温柔女声",
        "language": "中文",
        "description": "柔和、亲切的女性声音",
        "preview_text": "你好,我是你的语音助手",
        "provider": "minimax",
        "purchased": true
      }
    ],
    "total": 12
  }
}