Skip to Content
API 文档Audio获取官方音色详情

获取官方音色详情

接口说明

本接口用于通过 API 获取对应模型的系统默认音色,支持查询指定模型下的所有系统音色,并返回每个音色的详细信息(名称、描述、推荐场景)。

如果将该接口提供给 agent,agent 可拿到当前全部官方音色和描述,并根据场景选择最适配的音色。

请求说明

请求方式

GET

请求路径

/v1/audio/system_voices

Query 参数

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

请求示例

GET /v1/audio/system_voices?model=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": [ ], "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