查询可用音色ID

查询不同分类下的音色信息,获取当前账号下可调用的全部音色 ID(voice_id),包含系统音色、快速复刻音色生成的音色。

POST/v1/audio/voices/query

授权

Authorizationstringheader必填
HTTP: Bearer Auth
  • Security Scheme Type: http
  • HTTP Authorization Scheme: Bearer API_key,用于验证账户信息,可在 项目管理>API Key 中查看。

请求头

Content-Typeenum<string>默认值: application/json必填

请求体 application/json

voice_typeenum<string>必填

待查询音色类型:
  • system系统预定义音色
  • voice_cloning快速复刻音色(仅成功用于语音合成后可查)
  • all所有类型音色

响应体结构

system_voicearray<object>

系统预定义的音色数据数组,无符合条件数据则返回空数组

system_voice[i].voice_idstring

系统音色的唯一标识 ID

system_voice[i].descriptionarray<string>

音色的描述信息,含风格、适用场景等

system_voice[i].voice_namestring

音色的中文名称

voice_cloningarray<object>

快速复刻的音色数据数组,无符合条件数据则返回空数组

voice_cloning[i].voice_idstring

快速复刻音色的唯一标识 ID

voice_cloning[i].created_timestring

复刻音色的创建时间

base_respobject

本次请求的基础状态信息

base_resp.status_codeint64

请求状态码,0 表示请求成功

base_resp.status_msgstring

请求状态描述,success 表示请求成功

trace_idstring

请求ID,用于追踪请求