一、评测模式描述
·评测要求：支持不超过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": "1650474c-2b83-4d4f-820e-e6590c831b69_10",
"voice_id": "1650474c-2b83-4d4f-820e-e6590c831b69",
"result": {
"SuggestedScore": 98.51323699951172,
"PronAccuracy": 98.51323699951172,
"PronFluency": 0.9656875133514404,
"PronCompletion": 1,
"Words": [
{
"MemBeginTime": 160,
"MemEndTime": 300,
"PronAccuracy": 96.01470947265625,
"PronFluency": 0.9704024791717529,
"ReferenceWord": "i_0",
"Word": "i",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": 300,
"MemEndTime": 480,
"PronAccuracy": 99.027587890625,
"PronFluency": 0.9832581281661987,
"ReferenceWord": "go_1",
"Word": "go",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": 480,
"MemEndTime": 580,
"PronAccuracy": 98.93866729736328,
"PronFluency": 1,
"ReferenceWord": "to_2",
"Word": "to",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": 580,
"MemEndTime": 940,
"PronAccuracy": 99.04634094238281,
"PronFluency": 0.9832895994186401,
"ReferenceWord": "school_3",
"Word": "school",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": 940,
"MemEndTime": 1100,
"PronAccuracy": 99.0534439086914,
"PronFluency": 0.9959675073623657,
"ReferenceWord": "by_4",
"Word": "by",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": 1100,
"MemEndTime": 1680,
"PronAccuracy": 98.99871063232422,
"PronFluency": 0.8612076640129089,
"ReferenceWord": "bus_5",
"Word": "bus",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
}
],
"SentenceId": -1,
"RefTextId": 0,
"KeyWordHits": null,
"UnKeyWordHits": null
},
"final": 1
}
四、原始单词
数字类型使用英文评测会转换为对应英文单词，可在对应返回字段获取原始数字以及单词下标。
五、请求参数
主要请求参数说明：
| 参数名称 | 类型 | 描述 |
| ref_text | String | 被评估文本。不超过30个单词 |
| eval_mode | Integer | 评估模式。2：段落评测模式 |
请求示例
# 参数示例为websocket连接URL展开, 如：soe.cloud.tencent.com/soe/api/1306***?eval_mode=0&voice_format=1&…server_engine_type=16k_eneval_mode=2rec_mode=0ref_text="61"score_coeff=1.000000voice_format=1
六、返回结果
主要返回结果说明：
| 参数名称 | 类型 | 描述 |
| Words.ReferenceWord | String | 原始单词 |
返回示例
类似句子评测返回
七、主题词和关键词
使用|划分多组文本，每组不超过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_eneval_mode=2rec_mode=0ref_text="i go to school by bus | i go to school by train | i go to school by car"keyword="bus | train | car"score_coeff=1.000000voice_format=1
九、返回结果
主要返回结果说明：
| 参数名称 | 类型 | 描述 |
| Words.KeywordTag | Integer | 主题词命中标志 |
| RefTextId | Integer | 匹配候选文本的序号 |
| KeywordHits | Array of Integer | 主题词命中标志 |
返回示例
{
"code": 0,
"message": "e5671846-5b25-4619-9581-1833605e48a2_1",
"voice_id": "e5671846-5b25-4619-9581-1833605e48a2",
"result": {
"SuggestedScore": 98.51323699951172,
"PronAccuracy": 98.51323699951172,
"PronFluency": 0.9656875133514404,
"PronCompletion": 1,
"Words": [
{
"MemBeginTime": 160,
"MemEndTime": 300,
"PronAccuracy": 96.01470947265625,
"PronFluency": 0.9704024791717529,
"ReferenceWord": "i_0",
"Word": "i",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": 300,
"MemEndTime": 480,
"PronAccuracy": 99.027587890625,
"PronFluency": 0.9832581281661987,
"ReferenceWord": "go_1",
"Word": "go",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": 480,
"MemEndTime": 580,
"PronAccuracy": 98.93867492675781,
"PronFluency": 1,
"ReferenceWord": "to_2",
"Word": "to",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": 580,
"MemEndTime": 940,
"PronAccuracy": 99.04634094238281,
"PronFluency": 0.9832895994186401,
"ReferenceWord": "school_3",
"Word": "school",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": 940,
"MemEndTime": 1100,
"PronAccuracy": 99.0534439086914,
"PronFluency": 0.9959675073623657,
"ReferenceWord": "by_4",
"Word": "by",
"MatchTag": 0,
"KeywordTag": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
},
{
"MemBeginTime": 1100,
"MemEndTime": 1680,
"PronAccuracy": 98.99871063232422,
"PronFluency": 0.8612076640129089,
"ReferenceWord": "bus_5",
"Word": "bus",
"MatchTag": 0,
"KeywordTag": 1,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
}
],
"SentenceId": -1,
"RefTextId": 0,
"KeyWordHits": [
1,
0,
0
],
"UnKeyWordHits": null
},
"final": 1
}