一、评测模式描述
·评测要求:支持不超过30个汉字,60秒音频时长。
·评测维度:支持返回单词精准度,流利度,完整度,切题度。
·评测功能:支持多组文本,主题词和关键词,关键词组,候选单词数组,负向关键词,指定发音。
二、请求参数
主要请求参数说明
| 参数名称 | 类型 | 描述 |
| ref_text | String | 被评估文本。可以使用 | 划分成多个分支 |
| eval_mode | Integer | 评估模式。5:情景评测模式 |
请求示例
三、返回结果
主要返回结果如下:
| 参数名称 | 类型 | 描述 |
| SuggestedScore | Float | 建议评分 |
| PronAccuracy | Float | 整体精准度 |
| PronFluency | Float | 整体流利度 |
| PronCompletion | Float | 整体完整度 |
| Words.PronAccuracy | Float | 单词精准度 |
| Words.PronFluency | Float | 单词流利度 |
| Words.MatchTag | Integer | 当前词的音频与文本的匹配情况 |
返回示例
{
"code": 0,
"message": "4b1c4ba9-356c-490d-bd5a-757c6780e565_8",
"voice_id": "4b1c4ba9-356c-490d-bd5a-757c6780e565",
"result": {
"SuggestedScore": 98.82364654541016,
"PronAccuracy": 98.82364654541016,
"PronFluency": 0.9782572984695435,
"PronCompletion": 1,
"Words": [
{
"MemBeginTime": 150,
"MemEndTime": 530,
"PronAccuracy": 98.3575439453125,
"PronFluency": 0.9699531197547913,
"ReferenceWord": "",
"Word": "山",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": 530,
"MemEndTime": 700,
"PronAccuracy": 98.8291244506836,
"PronFluency": 1,
"ReferenceWord": "",
"Word": "水",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": 700,
"MemEndTime": 940,
"PronAccuracy": 99.136474609375,
"PronFluency": 0.9950633645057678,
"ReferenceWord": "",
"Word": "画",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": 940,
"MemEndTime": 1440,
"PronAccuracy": 98.97146606445312,
"PronFluency": 0.9480128288269043,
"ReferenceWord": "",
"Word": "作",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
}
],
"SentenceId": -1,
"RefTextId": 1,
"KeyWordHits": null,
"UnKeyWordHits": null
},
"final": 1
}
四、主题词和关键词
使用|划分多组文本,每组不超过120个单词。当预设多组文本时,没有实时结果。
五、请求参数
主要请求参数说明
| 参数名称 | 类型 | 描述 |
| ref_text | String | 被评估文本。可以使用 | 划分成多个分支 |
| keyword | String | 主题词和关键词。使用|划分不同主题词,使用#划分不同主题词组 |
| eval_mode | Integer | 评估模式。5:情景评测模式 |
请求示例
# 参数示例为websocket连接URL展开, 如:soe.cloud.tencent.com/soe/api/1306***?eval_mode=0&voice_format=1&…server_engine_type=16k_zheval_mode=5ref_text="油画 | 山水画作"keyword="油 | 山水画 | 绘画"score_coeff=1.000000voice_format=1
六、返回结果
主要返回结果如下:
| 参数名称 | 类型 | 描述 |
| PronAccuracy | Float | 精准度 |
| PronCompletion | Float | 切题度 |
| Words.KeywordTag | Integer | 主题词命中标志 |
| RefTextId | Integer | 匹配候选文本的序号 |
| KeyWordHits | Array of Integer | 主题词命中标志 |
| UnKeyWordHits | Array of Integer | 负向主题词命中标志 |
返回示例
{
"code": 0,
"message": "617cc654-4c70-49c1-88e2-bb5f5c496443_8",
"voice_id": "617cc654-4c70-49c1-88e2-bb5f5c496443",
"result": {
"SuggestedScore": 98.82364654541016,
"PronAccuracy": 98.82364654541016,
"PronFluency": 0.9782572984695435,
"PronCompletion": 1,
"Words": [
{
"MemBeginTime": 150,
"MemEndTime": 530,
"PronAccuracy": 98.3575439453125,
"PronFluency": 0.9699531197547913,
"ReferenceWord": "",
"Word": "山",
"MatchTag": 0,
"KeywordTag": 1,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": 530,
"MemEndTime": 700,
"PronAccuracy": 98.8291244506836,
"PronFluency": 1,
"ReferenceWord": "",
"Word": "水",
"MatchTag": 0,
"KeywordTag": 1,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": 700,
"MemEndTime": 940,
"PronAccuracy": 99.136474609375,
"PronFluency": 0.9950633645057678,
"ReferenceWord": "",
"Word": "画",
"MatchTag": 0,
"KeywordTag": 1,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": 940,
"MemEndTime": 1440,
"PronAccuracy": 98.97146606445312,
"PronFluency": 0.9480128288269043,
"ReferenceWord": "",
"Word": "作",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
}
],
"SentenceId": -1,
"RefTextId": 1,
"KeyWordHits": [
1
],
"UnKeyWordHits": null
},
"final": 1
}
七、候选单词数组
除了使用 | 划分不同分支,也可以使用 @@{::words{文本}, {文本}} 来划分多个分支。二者可以同时使用。
八、请求参数
主要请求参数说明
| 参数名称 | 类型 | 描述 |
| ref_text | String | 被评估文本。@@{::words{文本}, {文本}}表示候选单词词组 |
| eval_mode | Integer | 评估模式。5:情景评测模式 |
请求示例
# 参数示例为websocket连接URL展开, 如:soe.cloud.tencent.com/soe/api/1306***?eval_mode=0&voice_format=1&…server_engine_type=16k_zheval_mode=5ref_text="油画 | 山水画作"keyword="油 | 山水画 | 绘画"score_coeff=1.000000voice_format=1
九、返回结果
主要返回结果
| 参数名称 | 类型 | 描述 |
| PronAccuracy | Float | 准确度 |
| PronCompletion | Float | 切题度 |
| Words.KeywordTag | Integer | 主题词命中标志 |
| RefTextId | Integer | 匹配候选文本的序号。候选单词词组在同一序号内 |
| KeyWordHits | Array of Integer | 主题词命中标志 |
| UnKeyWordHits | Array of Integer | 负向主题词命中标志 |
返回示例
{
"code": 0,
"message": "ad96a3d8-03d6-4a44-b34f-0c1324d290af_8",
"voice_id": "ad96a3d8-03d6-4a44-b34f-0c1324d290af",
"result": {
"SuggestedScore": 82.9704818725586,
"PronAccuracy": 98.77437591552734,
"PronFluency": 0.9883387684822083,
"PronCompletion": 0.6000000238418579,
"Words": [
{
"MemBeginTime": -1,
"MemEndTime": -1,
"PronAccuracy": -1,
"PronFluency": -1,
"ReferenceWord": "",
"Word": "一",
"MatchTag": 2,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": -1,
"MemEndTime": -1,
"PronAccuracy": -1,
"PronFluency": -1,
"ReferenceWord": "",
"Word": "幅",
"MatchTag": 2,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": 150,
"MemEndTime": 530,
"PronAccuracy": 98.3575439453125,
"PronFluency": 0.9699531197547913,
"ReferenceWord": "",
"Word": "山",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": 530,
"MemEndTime": 700,
"PronAccuracy": 98.8291244506836,
"PronFluency": 1,
"ReferenceWord": "",
"Word": "水",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": 700,
"MemEndTime": 940,
"PronAccuracy": 99.136474609375,
"PronFluency": 0.9950633645057678,
"ReferenceWord": "",
"Word": "画",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": -1,
"MemEndTime": -1,
"PronAccuracy": -1,
"PronFluency": -1,
"ReferenceWord": "*",
"Word": "*",
"MatchTag": 1,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
}
],
"SentenceId": -1,
"RefTextId": 0,
"KeyWordHits": null,
"UnKeyWordHits": null
},
"final": 1
}
十、负向主题词
使用 {::cmd{F_UKEY=true}} 表示负向主题词,匹配到负向主题词评分为0。
十一、请求参数
主要请求参数说明
| 参数名称 | 类型 | 描述 |
| ref_text | String | 被评估文本 |
| eval_mode | Integer | 评估模式。5:情景评测模式 |
请求示例
# 参数示例为websocket连接URL展开, 如:soe.cloud.tencent.com/soe/api/1306***?eval_mode=0&voice_format=1&…server_engine_type=16k_zheval_mode=5ref_text="油画 | 山水画作"keyword="{::cmd{F_UKEY=true}} 画 | 山水画 # 绘画"score_coeff=1.000000voice_format=1
十二、返回结果
主要返回结果
| 参数名称 | 类型 | 描述 |
| UnKeyWordHits | Array of Float | 负向主题词命中标志 |
返回示例
{
"code": 0,
"message": "c30502e6-7289-4c5d-8b3a-b72a6a16a0d3_8",
"voice_id": "c30502e6-7289-4c5d-8b3a-b72a6a16a0d3",
"result": {
"SuggestedScore": 0,
"PronAccuracy": 0,
"PronFluency": -1,
"PronCompletion": -1,
"Words": [
],
"SentenceId": -1,
"RefTextId": -1,
"KeyWordHits": null,
"UnKeyWordHits": [
1
]
},
"final": 1
}
十三、指定发音
使用 汉字{::pron{p1,p2..},{p3,p4..}..} 指定发音,发音单元为 拼音。
十四、请求参数
主要请求参数说明
| 参数名称 | 类型 | 描述 |
| ref_text | String | 被评估文本 |
| eval_mode | Integer | 评估模式。5:段落评测模式 |
请求示例
# 参数示例为websocket连接URL展开, 如:soe.cloud.tencent.com/soe/api/1306***?eval_mode=0&voice_format=1&…server_engine_type=16k_zheval_mode=5ref_text="清平乐{::pron{yue4}}"score_coeff=1.000000voice_format=1
十五、返回结果
主要返回结果说明
| 参数名称 | 类型 | 描述 |
| SuggestedScore | Float | 建议评分 |
| PronAccuracy | Float | 整体精准度 |
| PronFluency | Float | 整体流利度 |
| Words.PronAccuracy | Float | 单词精准度 |
| Words.PronFluency | Float | 单词流利度 |
返回示例
{
"code": 0,
"message": "d5f712e6-2e10-4ed4-af97-07f35ad96a07_6",
"voice_id": "d5f712e6-2e10-4ed4-af97-07f35ad96a07",
"result": {
"SuggestedScore": 98.83511352539062,
"PronAccuracy": 98.83511352539062,
"PronFluency": 0.9852638244628906,
"PronCompletion": 1,
"Words": [
{
"MemBeginTime": 230,
"MemEndTime": 540,
"PronAccuracy": 98.67828369140625,
"PronFluency": 0.9863236546516418,
"ReferenceWord": "",
"Word": "清",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": 540,
"MemEndTime": 730,
"PronAccuracy": 98.99861145019531,
"PronFluency": 1,
"ReferenceWord": "",
"Word": "平",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": 730,
"MemEndTime": 1070,
"PronAccuracy": 98.82843780517578,
"PronFluency": 0.96946781873703,
"ReferenceWord": "",
"Word": "乐",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
}
],
"SentenceId": -1,
"RefTextId": 0,
"KeyWordHits": null,
"UnKeyWordHits": null
},
"final": 1
}