一、评估模式描述
·评测要求：支持不超过120个汉字，300秒音频时长。
·评测维度：支持返回单词精准度，流利度，完整度。
·评测功能：支持实时评测，多组文本，主题词和关键词，指定发音。
二、请求参数
主要请求参数说明：
| 参数名称 | 类型 | 描述 |
| ref_text | String | 被评估文本。不超过120个汉字 |
| eval_mode | Integer | 评估模式。2：段落评测模式 |
请求示例
三、返回结果
主要返回结果说明：
| 参数名称 | 类型 | 描述 |
| SuggestedScore | Float | 建议评分 |
| PronAccuracy | Float | 整体精准度 |
| PronFluency | Float | 整体流利度 |
| PronCompletion | Float | 整体完整度 |
| Words.PronAccuracy | Float | 单词精准度 |
| Words.PronFluency | Float | 单词流利度 |
| Words.MatchTag | Integer | 当前词的音频与文本的匹配情况 |
请求示例
{ "code": 0, "message": "74a1c228-d062-4326-a8af-91d6180a61af_82", "voice_id": "74a1c228-d062-4326-a8af-91d6180a61af", "result": { "SuggestedScore": 95.77880859375, "PronAccuracy": 95.77880859375, "PronFluency": 0.99004727602005, "PronCompletion": 1, "Words": [ { "MemBeginTime": 150, "MemEndTime": 410, "PronAccuracy": 98.7235336303711, "PronFluency": 0.9854370951652527, "ReferenceWord": "", "Word": "君", "MatchTag": 0, "KeywordTag": 0, "PhoneInfos": [
], "Tone": { "Valid": false, "RefTone": -1, "HypothesisTone": -1 } }, { "MemBeginTime": 410, "MemEndTime": 520, "PronAccuracy": 62.09292984008789, "PronFluency": 1, "ReferenceWord": "", "Word": "不", "MatchTag": 0, "KeywordTag": 0, "PhoneInfos": [
], "Tone": { "Valid": false, "RefTone": -1, "HypothesisTone": -1 } }, { "MemBeginTime": 520, "MemEndTime": 720, "PronAccuracy": 97.01541900634766, "PronFluency": 1, "ReferenceWord": "", "Word": "见", "MatchTag": 0, "KeywordTag": 0, "PhoneInfos": [
], "Tone": { "Valid": false, "RefTone": -1, "HypothesisTone": -1 } }, { "MemBeginTime": 720, "MemEndTime": 970, "PronAccuracy": 98.4925537109375, "PronFluency": 0.9984045028686523, "ReferenceWord": "", "Word": "黄", "MatchTag": 0, "KeywordTag": 0, "PhoneInfos": [
], "Tone": { "Valid": false, "RefTone": -1, "HypothesisTone": -1 } }, { "MemBeginTime": 970, "MemEndTime": 1180, "PronAccuracy": 99.08226776123047, "PronFluency": 0.989464521408081, "ReferenceWord": "", "Word": "河", "MatchTag": 0, "KeywordTag": 0, "PhoneInfos": [
], "Tone": { "Valid": false, "RefTone": -1, "HypothesisTone": -1 } }, { "MemBeginTime": 1180, "MemEndTime": 1320, "PronAccuracy": 99.10519409179688, "PronFluency": 1, "ReferenceWord": "", "Word": "之", "MatchTag": 0, "KeywordTag": 0, "PhoneInfos": [
], "Tone": { "Valid": false, "RefTone": -1, "HypothesisTone": -1 } }, { "MemBeginTime": 1320, "MemEndTime": 1590, "PronAccuracy": 99.03042602539062, "PronFluency": 0.9964998960494995, "ReferenceWord": "", "Word": "水", "MatchTag": 0, "KeywordTag": 0, "PhoneInfos": [
], "Tone": { "Valid": false, "RefTone": -1, "HypothesisTone": -1 } }, { "MemBeginTime": 1590, "MemEndTime": 1820, "PronAccuracy": 98.69737243652344, "PronFluency": 0.9987477660179138, "ReferenceWord": "", "Word": "天", "MatchTag": 0, "KeywordTag": 0, "PhoneInfos": [
], "Tone": { "Valid": false, "RefTone": -1, "HypothesisTone": -1 } }, { "MemBeginTime": 1820, "MemEndTime": 2020, "PronAccuracy": 98.7934799194336, "PronFluency": 0.9994363784790039, "ReferenceWord": "", "Word": "上", "MatchTag": 0, "KeywordTag": 0, "PhoneInfos": [
], "Tone": { "Valid": false, "RefTone": -1, "HypothesisTone": -1 } }, { "MemBeginTime": 2020, "MemEndTime": 2380, "PronAccuracy": 98.8353271484375, "PronFluency": 0.9614326357841492, "ReferenceWord": "", "Word": "来", "MatchTag": 0, "KeywordTag": 0, "PhoneInfos": [
], "Tone": { "Valid": false, "RefTone": -1, "HypothesisTone": -1 } }, { "MemBeginTime": 2470, "MemEndTime": 2660, "PronAccuracy": 94.79298400878906, "PronFluency": 0.9956367015838623, "ReferenceWord": "", "Word": "奔", "MatchTag": 0, "KeywordTag": 0, "PhoneInfos": [
], "Tone": { "Valid": false, "RefTone": -1, "HypothesisTone": -1 } } ], "SentenceId": -1, "RefTextId": 0, "KeyWordHits": null, "UnKeyWordHits": null }, "final": 1}
四、主题词和关键词返回示例
使用|划分多组文本，每组不超过120个单词。当预设多组文本时，没有实时结果。
五、请求参数
主要请求参数说明：
| 参数名称 | 类型 | 描述 |
| ref_text | String | 被评估文本。可以使用 | 划分成多个分支 |
| keyword | String | 主题词和关键词。使用|划分不同主题词 |
| eval_mode | Integer | 评估模式。2：段落评测模式 |
请求示例
# 参数示例为websocket连接URL展开, 如：soe.cloud.tencent.com/soe/api/1306***?eval_mode=0&voice_format=1&…server_engine_type=16k_zheval_mode=2ref_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": "2376994a-4f97-4f3d-898b-c6eef77db858_8",
"voice_id": "2376994a-4f97-4f3d-898b-c6eef77db858",
"result": {
"SuggestedScore": 98.82365417480469,
"PronAccuracy": 98.82365417480469,
"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": [
0,
1,
0
],
"UnKeyWordHits": null
},
"final": 1
}
七、指定发音
使用 汉字 {::pron{p1,p2..},{p3,p4..}..} 指定发音，发音单元为 拼音。
八、请求参数
主要请求参数说明：
| 参数名称 | 类型 | 描述 |
| ref_text | String | 被评估文本 |
| eval_mode | Integer | 评估模式。2：段落评测模式 |
请求示例
# 参数示例为websocket连接URL展开, 如：soe.cloud.tencent.com/soe/api/1306***?eval_mode=0&voice_format=1&…server_engine_type=16k_zheval_mode=2ref_text="清平乐{::pron{yue4}}"score_coeff=1.000000voice_format=1
九、返回结果
主要返回结果说明：
| 参数名称 | 类型 | 描述 |
| SuggestedScore | Float | 建议评分 |
| PronAccuracy | Float | 整体精准度 |
| PronFluency | Float | 整体流利度 |
| Words.PronAccuracy | Float | 单词精准度 |
| Words.PronFluency | Float | 单词流利度 |
返回示例
{
"code": 0,
"message": "90c6517e-0734-4265-aef5-43b8d8a6593e_6",
"voice_id": "90c6517e-0734-4265-aef5-43b8d8a6593e",
"result": {
"SuggestedScore": 91.36042022705078,
"PronAccuracy": 91.36042022705078,
"PronFluency": 0.9832284450531006,
"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": 670,
"PronAccuracy": 77.00887298583984,
"PronFluency": 1,
"ReferenceWord": "",
"Word": "平",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": 670,
"MemEndTime": 1070,
"PronAccuracy": 98.39410400390625,
"PronFluency": 0.9633617401123047,
"ReferenceWord": "",
"Word": "乐",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
}
],
"SentenceId": -1,
"RefTextId": 0,
"KeyWordHits": null,
"UnKeyWordHits": null
},
"final": 1
}