一、评测模式描述
·评测要求:支持不超过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": "94aaa872-24d3-4199-a412-3d8b1bb65e89_11",
"voice_id": "94aaa872-24d3-4199-a412-3d8b1bb65e89",
"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": 0,
"PhoneInfos": [
],
"Tone": {
"Valid": false,
"RefTone": -1,
"HypothesisTone": -1
}
}
],
"SentenceId": -1,
"RefTextId": 0,
"KeyWordHits": null,
"UnKeyWordHits": null
},
"final": 1
}
四、主题词和关键词
可以使用|划分多组文本,每组不超过120个单词。
五、请求参数
主要请求参数说明
| 参数名称 | 类型 | 描述 |
| ref_text | String | 被评估文本 |
| keyword | Sting | 主题词和关键词。使用|划分不同主题词,使用#划分不同主题词组 |
| eval_mode | Integer | 评估模式。5:情景评测模式 |
请求示例
# 参数示例为websocket连接URL展开, 如:soe.cloud.tencent.com/soe/api/1306***?eval_mode=0&voice_format=1&…server_engine_type=16k_eneval_mode=5# 长音频推荐流式rec_mode=0# 流式展示中间结果sentence_info_enabled=1ref_text="i go to school by bus | i go to school by train | i go to school by car"keyword="bus | {::cmd{F_UKEY=true}} train # car"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": "e490d42f-4b92-4790-9797-1c573d346af3_11",
"voice_id": "e490d42f-4b92-4790-9797-1c573d346af3",
"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
],
"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_eneval_mode=5# 长音频推荐流式rec_mode=0# 流式展示中间结果sentence_info_enabled=1ref_text="i go to school by @@{::words{bus}, {train},{bike}}"keyword=""score_coeff=1.000000voice_format=1
九、返回结果
主要返回结果
| 参数名称 | 类型 | 描述 |
| SuggestedScore | Float | 建议评分 |
| PronAccuracy | Float | 整体精准度 |
| PronFluency | Float | 整体流利度 |
| PronCompletion | Float | 整体完整度 |
| Words.PronAccuracy | Float | 单词精准度 |
| Words.PronFluency | Float | 单词流利度 |
| Words.MatchTag | Integer | 当前词的音频与文本的匹配情况 |
返回示例
{
"code": 0,
"message": "03f0a912-aa74-4269-b99c-ae833d84d44c_11",
"voice_id": "03f0a912-aa74-4269-b99c-ae833d84d44c",
"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": "@@_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
}
十、负向主题词
使用 {::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_eneval_mode=5# 长音频推荐流式rec_mode=0# 流式展示中间结果sentence_info_enabled=1ref_text="i go to school by @@{::words{train}, {bus},{bike}}"keyword="{::cmd{F_UKEY=true}} bus | train # bike"score_coeff=1.000000voice_format=1
十二、返回结果
主要返回结果
| 参数名称 | 类型 | 描述 |
| UnKeyWordHits | Array of Integer | 负向主题词命中标志 |
返回示例
{
"code": 0,
"message": "e48754e0-1ca3-4b83-bb67-16ccdee5e166_11",
"voice_id": "e48754e0-1ca3-4b83-bb67-16ccdee5e166",
"result": {
"SuggestedScore": 0,
"PronAccuracy": 0,
"PronFluency": -1,
"PronCompletion": -1,
"Words": [
],
"SentenceId": -1,
"RefTextId": -1,
"KeyWordHits": null,
"UnKeyWordHits": [
1
]
},
"final": 1
}