获取官方音色详情
接口说明
本接口用于通过 API 获取对应模型的系统默认音色,支持查询指定模型下的所有系统音色,并返回每个音色的详细信息(名称、描述、推荐场景)。
如果将该接口提供给 agent,agent 可拿到当前全部官方音色和描述,并根据场景选择最适配的音色。
请求说明
请求方式
GET
请求路径
/v1/audio/system_voicesQuery 参数
| 参数名 | 类型 | 是否必选 | 支持选项 | 说明 |
|---|---|---|---|---|
| model | string | 是 | step-tts-2 | 指定要查询系统音色的模型,目前仅支持 step-tts-2 |
请求示例
GET /v1/audio/system_voices?model=step-tts-2返回说明
返回格式
JSON
返回参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| voices | array[string] | 系统音色 ID 列表,包含该模型下所有系统音色的唯一标识 |
| voices-details | object | 音色详细信息集合,key 为音色 ID,value 为该音色的具体详情 |
| voices-details.xxx.voice-name | string | 音色名称,部分音色可能为空字符串 |
| voices-details.xxx.voice-description | string | 音色描述,包含音色性别、音色特点等信息 |
| voices-details.xxx.recommended_scene | string | 音色推荐使用场景,多个场景用顿号分隔 |
返回示例
{
"voices": [
],
"voices-details": {
"cixingnansheng": {
"voice-name": "磁性男声",
"voice-description": "男,深情厚重,有感染力,霸总感",
"recommended_scene": "有声书、情感陪伴"
},
"linjiameimei": {
"voice-name": "邻家妹妹",
"voice-description": "女,可爱亲和,稚气感",
"recommended_scene": "视频配音、口播(解说、新闻)、语音助手"
},
"zhengpaiqingnian": {
"voice-name": "正派青年",
"voice-description": "男,音色具有感染力、说服力和亲和力,有激情和鼓动性",
"recommended_scene": "营销"
},
"dushexiaoyu": {
"voice-name": "",
"voice-description": "男,温柔亲和",
"recommended_scene": "口播(解说、新闻)、情感陪伴、客服与业务办理、教育与培训"
},
"elegantgentle-female": {
"voice-name": "气质温婉",
"voice-description": "女,真诚温柔,亲和力强,给人安全感",
"recommended_scene": "客服与业务办理、口播(解说、新闻)、教育与培训、情感陪伴"
},
"ruanmengnvsheng": {
"voice-name": "软萌女声",
"voice-description": "女,可爱、甜、嗲",
"recommended_scene": "情感陪伴、语音助手、视频配音"
},
"yuanqinansheng": {
"voice-name": "元气男声",
"voice-description": "男,情绪饱满有活力",
"recommended_scene": "有声书、口播(解说、新闻)"
},
"shuangkuaijiejie": {
"voice-name": "爽快姐姐",
"voice-description": "女,清澈有活力",
"recommended_scene": "口播(解说、新闻)、语音助手"
},
"shanghaifemalezh": {
"voice-name": "",
"voice-description": "女,上海话音色",
"recommended_scene": "口播(解说、新闻)、视频配音"
},
"zixinnansheng": {
"voice-name": "自信男声",
"voice-description": "男,真诚亲和,有活力",
"recommended_scene": "有声书、情感陪伴、教育与培训、营销"
},
"wenjingxuejie": {
"voice-name": "文静学姐",
"voice-description": "女,冷静沉稳,吐字清晰稳定",
"recommended_scene": "口播(解说、新闻)、语音助手"
},
"yinhejingling": {
"voice-name": "",
"voice-description": "女,温柔、轻盈有活力,亲和力强",
"recommended_scene": "客服与业务办理、语音助手"
},
"qingchunshaonv": {
"voice-name": "清纯少女",
"voice-description": "女,温柔、轻盈有活力,亲和力强",
"recommended_scene": "客服与业务办理、语音助手"
},
"livelybreezy-female": {
"voice-name": "活力轻快",
"voice-description": "女,音色具有感染力、说服力和亲和力,有活力",
"recommended_scene": "情感陪伴、教育与培训、营销"
},
"ganliannvsheng": {
"voice-name": "干练女声",
"voice-description": "女,音色沉稳冷静、慢条斯理,专业感强",
"recommended_scene": "客服与业务办理、语音助手"
},
"tianmeinvsheng": {
"voice-name": "甜美女声",
"voice-description": "女,甜美温柔,亲和力强",
"recommended_scene": "情感陪伴、客服与业务办理"
},
"shanghaimale": {
"voice-name": "",
"voice-description": "男,上海话音色",
"recommended_scene": "口播(解说、新闻)、视频配音"
},
"vibrant-youth": {
"voice-name": "Vibrant Youth",
"voice-description": "男,英文音色,温柔亲和",
"recommended_scene": "有声书、视频配音、语音助手"
},
"ruyananshi": {
"voice-name": "儒雅男士",
"voice-description": "男,沉稳厚重,叙述感强,有亲和力、陪伴感",
"recommended_scene": "有声书、情感陪伴、口播(解说、新闻)、语音助手"
},
"youyanvsheng": {
"voice-name": "优雅女声",
"voice-description": "女,成熟亲和,给人踏实感",
"recommended_scene": "视频配音"
},
"jingdiannvsheng": {
"voice-name": "经典女声",
"voice-description": "女,语速较慢,真诚温柔",
"recommended_scene": "客服与业务办理、情感陪伴"
},
"linjiajiejie": {
"voice-name": "邻家姐姐",
"voice-description": "女,有亲和力,邻家大姐姐的感觉,给人安全感",
"recommended_scene": "口播(解说、新闻)、情感陪伴、语音助手、视频配音"
},
"energeticconfident-female": {
"voice-name": "",
"voice-description": "女,英文音色,有活力且自信",
"recommended_scene": "客服与业务办理、语音助手"
},
"boyinnansheng": {
"voice-name": "播音男声",
"voice-description": "男,播音腔,中正平稳",
"recommended_scene": "有声书、口播(解说、新闻)"
},
"yuanqishaonv": {
"voice-name": "元气少女",
"voice-description": "女,声线细腻,甜、嗲",
"recommended_scene": "情感陪伴、语音助手"
},
"shuangkuainansheng": {
"voice-name": "爽快男声",
"voice-description": "男,音色沉稳冷静、慢条斯理,专业感强",
"recommended_scene": "客服与业务办理、语音助手"
},
"shanghaifemale": {
"voice-name": "",
"voice-description": "女,上海话音色",
"recommended_scene": "口播(解说、新闻)、视频配音"
},
"qingniandaxuesheng": {
"voice-name": "青年大学生",
"voice-description": "男,沉稳厚实,播音专业感",
"recommended_scene": "口播(解说、新闻)"
},
"zhixingjiejie": {
"voice-name": "知性姐姐",
"voice-description": "女,成熟沉稳,叙述有画面感",
"recommended_scene": "视频配音、口播(解说、新闻)、语音助手"
},
"qinqienvsheng": {
"voice-name": "亲切女声",
"voice-description": "女,温柔带点甜美,亲和力强,邻家感",
"recommended_scene": "口播(解说、新闻)、情感陪伴、语音助手"
},
"wenroushunv": {
"voice-name": "温柔熟女",
"voice-description": "女,成熟稳重,温柔有亲和力",
"recommended_scene": "客服与业务办理、口播(解说、新闻)、教育与培训"
},
"qinhenvsheng": {
"voice-name": "亲和女声",
"voice-description": "女,冷静温柔、有亲和力",
"recommended_scene": "客服与业务办理、语音助手"
},
"shenchennanyin": {
"voice-name": "深沉男音",
"voice-description": "男,有感情,代入感强,给人信心",
"recommended_scene": "情感陪伴、有声书"
},
"huolinvsheng": {
"voice-name": "活力女声",
"voice-description": "女,轻盈有活力,亲和力强",
"recommended_scene": "客服与业务办理、语音助手"
},
"wenrougongzi": {
"voice-name": "温柔公子",
"voice-description": "男,沉稳温柔,叙述感强",
"recommended_scene": "情感陪伴、有声书"
},
"soft-spoken-gentleman": {
"voice-name": "Soft-spoken Gentleman",
"voice-description": "男,英文音色,沉稳温柔,给人安全感",
"recommended_scene": "情感陪伴、有声书"
},
"lively-girl": {
"voice-name": "Lively Girl",
"voice-description": "女,英文音色,亲和感,有活力",
"recommended_scene": "有声书、视频配音、语音助手"
},
"wenrounvsheng": {
"voice-name": "温柔女声",
"voice-description": "女,温柔甜美,叙述感强,有关怀感",
"recommended_scene": "有声书、情感陪伴"
},
"wenrounansheng": {
"voice-name": "温柔男声",
"voice-description": "男,温柔亲和",
"recommended_scene": "口播(解说、新闻)、情感陪伴、客服与业务办理、教育与培训"
},
"yingwennansheng": {
"voice-name": "",
"voice-description": "男,英文音色,有亲和力",
"recommended_scene": "有声书、视频配音、语音助手"
},
"yingwennvsheng": {
"voice-name": "",
"voice-description": "女,英文音色,沉稳温柔",
"recommended_scene": "有声书、视频配音、语音助手"
},
"jilingshaonv": {
"voice-name": "机灵少女",
"voice-description": "女,声线细腻,有活力",
"recommended_scene": "语音助手、口播(解说、新闻)"
},
"lengyanyujie": {
"voice-name": "冷艳御姐",
"voice-description": "女,播音感,专业不失亲和",
"recommended_scene": "视频配音"
},
"magnetic-voiced-male": {
"voice-name": "Magnetic-voiced Male",
"voice-description": "男,英文音色,强烈的沉稳厚重感",
"recommended_scene": "有声书、视频配音"
}
}
}注意事项
voices数组中的音色 ID 与voices-details中的 key 一一对应,可通过音色 ID 查询对应详情。- 推荐场景仅为参考,用户可根据实际需求选择合适的音色。
Last updated on