跳转到主要内容

接口说明

本接口用于通过 API 获取对应模型的系统默认音色,支持查询指定模型下的所有系统音色,并返回每个音色的详细信息(名称、描述、推荐场景)。 如果将该接口提供给 agent,agent 可拿到当前全部官方音色和描述,并根据场景选择最适配的音色。

请求说明

请求方式

GET

请求路径

Query 参数

参数名类型是否必选支持选项说明
modelstringstep-tts-2指定要查询系统音色的模型,目前仅支持 step-tts-2

请求示例

返回说明

返回格式

JSON

返回参数说明

参数名类型说明
voicesarray[string]系统音色 ID 列表,包含该模型下所有系统音色的唯一标识
voices-detailsobject音色详细信息集合,key 为音色 ID,value 为该音色的具体详情
voices-details.xxx.voice-namestring音色名称,部分音色可能为空字符串
voices-details.xxx.voice-descriptionstring音色描述,包含音色性别、音色特点等信息
voices-details.xxx.recommended_scenestring音色推荐使用场景,多个场景用顿号分隔

返回示例

注意事项

  • voices 数组中的音色 ID 与 voices-details 中的 key 一一对应,可通过音色 ID 查询对应详情。
  • 推荐场景仅为参考,用户可根据实际需求选择合适的音色。