查询可用音色

该 API 支持查询当前账号下可调用的全部音色（voice_id）。

包括系统音色、快速克隆音色，以及已在平台侧生成并保存成功的文生音色。

接口概览

接口地址: https://api.senseaudio.cn/v1/get_voice
请求方式: POST
Content-Type: application/json
鉴权方式: Bearer Token

请求配置

请求头 (Request Headers)

参数名	必填	说明	示例
Authorization	是	鉴权 Token。格式：Bearer SENSEAUDIO_API_KEY	Bearer sk-123456...
Content-Type	是	内容类型。固定为 application/json	application/json

请求参数 (Request Body)

参数名	类型	必填	描述	示例值
voice_type	string	是	希望查询的音色类型。 system: 系统音色 voice_clone: 快速复刻的音色，仅在成功用于语音合成后才可查询 voice_generation: 平台侧生成并保存成功的文生音色，仅在可调用后可查询 all: 以上全部	all

响应结构

成功响应

参数名	类型	描述
system_voice	array	系统预定义的音色列表
voice_cloning	array	快速复刻的音色列表
voice_generation	array	平台侧生成并可调用的文生音色列表
base_resp	object	本次请求的状态码和详情

system_voice 数组元素

参数名	类型	描述
voice_id	string	音色 ID
voice_name	string	音色名称，非调用的音色 ID
description	array	音色描述
created_time	string	创建时间，格式 yyyy-mm-dd

voice_cloning 数组元素

参数名	类型	描述
voice_id	string	快速复刻音色 ID
description	array	复刻时填写的音色描述
created_time	string	创建时间，格式 yyyy-mm-dd

voice_generation 数组元素

参数名	类型	描述
voice_id	string	音色 ID
description	array	生成音色时填写的音色描述
created_time	string	创建时间，格式 yyyy-mm-dd

base_resp 对象

参数名	类型	描述
status_code	int64	状态码。0: 请求结果正常；2013: 输入参数信息不正常
status_msg	string	状态详情

错误响应

HTTP 401 - 鉴权失败

json

{
  "code": "authentication_error",
  "message": "invalid authorization"
}

HTTP 200 - 业务错误

无权访问指定音色

json

{
  "base_resp": {
    "status_code": 403,
    "status_msg": "no access to the specified voice"
  }
}

合成失败

json

{
  "base_resp": {
    "status_code": 500,
    "status_msg": ""
  }
}

代码示例

CURL

Python

JavaScript

Java

Swift

bash

curl -X POST https://api.senseaudio.cn/v1/get_voice \
  -H "Authorization: Bearer $SENSEAUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "voice_type": "all"
  }'

响应示例

json

{
  "system_voice": [
    {
      "voice_id": "Chinese (Mandarin)_Reliable_Executive",
      "description": ["一位沉稳可靠的中年男性高管声音，标准普通话，传递出值得信赖的感觉。"],
      "voice_name": "沉稳高管",
      "created_time": "1970-01-01"
    },
    {
      "voice_id": "Chinese (Mandarin)_News_Anchor",
      "description": ["一位专业、播音腔的中年女性新闻主播，标准普通话。"],
      "voice_name": "新闻女声",
      "created_time": "1970-01-01"
    }
  ],
  "voice_cloning": [
    {
      "voice_id": "test12345",
      "description": [],
      "created_time": "2025-08-20"
    },
    {
      "voice_id": "test12346",
      "description": [],
      "created_time": "2025-08-21"
    }
  ],
  "voice_generation": [
    {
      "voice_id": "ttv-voice-2025082011321125-2uEN0X1S",
      "description": [],
      "created_time": "2025-08-20"
    },
    {
      "voice_id": "ttv-voice-2025082014225025-ZCQt0U0k",
      "description": [],
      "created_time": "2025-08-20"
    }
  ],
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

查询可用音色

该 API 支持查询当前账号下可调用的全部音色（voice_id）。

包括系统音色、快速克隆音色，以及已在平台侧生成并保存成功的文生音色。

接口概览

接口地址: https://api.senseaudio.cn/v1/get_voice
请求方式: POST
Content-Type: application/json
鉴权方式: Bearer Token

请求配置

请求头 (Request Headers)

参数名	必填	说明	示例
Authorization	是	鉴权 Token。格式：Bearer SENSEAUDIO_API_KEY	Bearer sk-123456...
Content-Type	是	内容类型。固定为 application/json	application/json

请求参数 (Request Body)

参数名	类型	必填	描述	示例值
voice_type	string	是	希望查询的音色类型。 system: 系统音色 voice_clone: 快速复刻的音色，仅在成功用于语音合成后才可查询 voice_generation: 平台侧生成并保存成功的文生音色，仅在可调用后可查询 all: 以上全部	all

响应结构

成功响应

参数名	类型	描述
system_voice	array	系统预定义的音色列表
voice_cloning	array	快速复刻的音色列表
voice_generation	array	平台侧生成并可调用的文生音色列表
base_resp	object	本次请求的状态码和详情

system_voice 数组元素

参数名	类型	描述
voice_id	string	音色 ID
voice_name	string	音色名称，非调用的音色 ID
description	array	音色描述
created_time	string	创建时间，格式 yyyy-mm-dd

voice_cloning 数组元素

参数名	类型	描述
voice_id	string	快速复刻音色 ID
description	array	复刻时填写的音色描述
created_time	string	创建时间，格式 yyyy-mm-dd

voice_generation 数组元素

参数名	类型	描述
voice_id	string	音色 ID
description	array	生成音色时填写的音色描述
created_time	string	创建时间，格式 yyyy-mm-dd

base_resp 对象

参数名	类型	描述
status_code	int64	状态码。0: 请求结果正常；2013: 输入参数信息不正常
status_msg	string	状态详情

错误响应

HTTP 401 - 鉴权失败

json

{
  "code": "authentication_error",
  "message": "invalid authorization"
}

HTTP 200 - 业务错误

无权访问指定音色

json

{
  "base_resp": {
    "status_code": 403,
    "status_msg": "no access to the specified voice"
  }
}

合成失败

json

{
  "base_resp": {
    "status_code": 500,
    "status_msg": ""
  }
}

代码示例

CURL

Python

JavaScript

Java

Swift

bash

curl -X POST https://api.senseaudio.cn/v1/get_voice \
  -H "Authorization: Bearer $SENSEAUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "voice_type": "all"
  }'

响应示例

json

{
  "system_voice": [
    {
      "voice_id": "Chinese (Mandarin)_Reliable_Executive",
      "description": ["一位沉稳可靠的中年男性高管声音，标准普通话，传递出值得信赖的感觉。"],
      "voice_name": "沉稳高管",
      "created_time": "1970-01-01"
    },
    {
      "voice_id": "Chinese (Mandarin)_News_Anchor",
      "description": ["一位专业、播音腔的中年女性新闻主播，标准普通话。"],
      "voice_name": "新闻女声",
      "created_time": "1970-01-01"
    }
  ],
  "voice_cloning": [
    {
      "voice_id": "test12345",
      "description": [],
      "created_time": "2025-08-20"
    },
    {
      "voice_id": "test12346",
      "description": [],
      "created_time": "2025-08-21"
    }
  ],
  "voice_generation": [
    {
      "voice_id": "ttv-voice-2025082011321125-2uEN0X1S",
      "description": [],
      "created_time": "2025-08-20"
    },
    {
      "voice_id": "ttv-voice-2025082014225025-ZCQt0U0k",
      "description": [],
      "created_time": "2025-08-20"
    }
  ],
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}