腾讯云智聆口语评测语音输入模式介绍-教育服务解决方案
一次性评测
一次性评测，是一次性将音频数据上传进行评测。一般用于较短文件的评测。
请求参数
主要请求参数说明：
| 参数名称 | 类型 | 描述 |
| WorkMode | Integer | 语音输入模式。1：一次性评测 |
| UserVoiceData | String | 当前语音数据 |
| SeqId | Integer | 流式数据包的序号。1：初始化序号 |
| IsEnd | Integer | 是否传输完毕标志。1：传输完毕开始评估 |
请求示例
{ "WorkMode":1, "UserVoiceData":"UklGRka1CQBXQVZFZ*****************************", "SeqId":1, "IsEnd":1, "RefText":"hello", "VoiceFileType":3, "VoiceEncodeType":1, "SessionId":"d0cecf7a-6bca-11ed-bdb0-acde48001122", "EvalMode":0, "ScoreCoeff":1.0}
返回结果
正确返回结果
{ "Response":{ "SuggestedScore":9.398723, "PronAccuracy":9.398723, "PronFluency":0.8396871, "PronCompletion":1, "RequestId":"3b520d02-bc6a-4b3a-8396-fd4ecb0d63a8", "Words":[ { "MemBeginTime":1030, "MemEndTime":2040, "PronAccuracy":9.398723, "PronFluency":0.8396871, "ReferenceWord":"hello_0", "Word":"hello", "MatchTag":0, "KeywordTag":0, "PhoneInfos":[ { "MemBeginTime":1030, "MemEndTime":1570, "PronAccuracy":19.79675, "DetectedStress":false, "Phone":"hh", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 }, { "MemBeginTime":1570, "MemEndTime":1660, "PronAccuracy":0.24008001, "DetectedStress":false, "Phone":"ah", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 }, { "MemBeginTime":1660, "MemEndTime":1810, "PronAccuracy":0.015921298, "DetectedStress":true, "Phone":"l", "ReferencePhone":"", "ReferenceLetter":"", "Stress":true, "MatchTag":0 }, { "MemBeginTime":1810, "MemEndTime":2040, "PronAccuracy":17.542141, "DetectedStress":false, "Phone":"ow", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 } ] } ], "SessionId":"d0cecf7a-6bca-11ed-bdb0-acde48001122", "AudioUrl":"", "Status":"Finished" }}
错误返回结果
{ "Response":{ "RequestId":"8053e8ce-06d4-4100-9f10-4103cc53ab78", "Error":{ "Code":"FailedOperation.ServiceTimeout", "Message":"评测超时，请通过轮询查询评测结果，后续请使用分片传输或减少单次传输音频时长。" } }}
如果返回评测超时可以通过轮询查询，或者使用流式评测进行分片传输。
轮询查询
请求参数
| 参数名称 | 类型 | 描述 |
| IsQuery | Integer | 查询标识。1：查询 |
| SessionId | String | 语音段唯一标识。 |
请求示例评测超时后再次请求接口获取结果。此时只需要设置的SessionId和IsQuery，其他必填参数需要满足类型，即可查询。SessionId需要请求过评测接口才可以进行查询。
{ "IsQuery":1, "SessionId":"d0cecf7a-6bca-11ed-bdb0-acde48001122", "WorkMode":1, "UserVoiceData":"", "SeqId":1, "IsEnd":1, "RefText":"", "VoiceFileType":3, "VoiceEncodeType":1, "EvalMode":0, "ScoreCoeff":1.0}
返回结果
主要返回参数
| 参数名称 | 类型 | 描述 |
| Status | String | 评估 session 状态。Finished：评估完成 |
返回示例需要等到 Status 为 Finished，评估才完成。否则是还在评估中，可以重复发送请求来获取。
{ "Response":{ "SuggestedScore":9.398723, "PronAccuracy":9.398723, "PronFluency":0.8396871, "PronCompletion":1, "RequestId":"3b520d02-bc6a-4b3a-8396-fd4ecb0d63a8", "Words":[ { "MemBeginTime":1030, "MemEndTime":2040, "PronAccuracy":9.398723, "PronFluency":0.8396871, "ReferenceWord":"hello_0", "Word":"hello", "MatchTag":0, "KeywordTag":0, "PhoneInfos":[ { "MemBeginTime":1030, "MemEndTime":1570, "PronAccuracy":19.79675, "DetectedStress":false, "Phone":"hh", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 }, { "MemBeginTime":1570, "MemEndTime":1660, "PronAccuracy":0.24008001, "DetectedStress":false, "Phone":"ah", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 }, { "MemBeginTime":1660, "MemEndTime":1810, "PronAccuracy":0.015921298, "DetectedStress":true, "Phone":"l", "ReferencePhone":"", "ReferenceLetter":"", "Stress":true, "MatchTag":0 }, { "MemBeginTime":1810, "MemEndTime":2040, "PronAccuracy":17.542141, "DetectedStress":false, "Phone":"ow", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 } ] } ], "SessionId":"d0cecf7a-6bca-11ed-bdb0-acde48001122", "AudioUrl":"", "Status":"Finished" }}
流式评测
需要实时评测或者出现评测超时的问题，可以使用流式评测来解决。
请求参数
主要请求参数
| 参数名称 | 类型 | 描述 |
| WorkMode | Integer | 语音输入模式。0：流式评测 |
| UserVoiceData | String | 当前语音数据 |
| SeqId | Integer | 流式数据包的序号。1：初始化序号，从1开始一次累加 |
| IsEnd | Integer | 是否传输完毕标志。1：传输完毕开始评估。0：传输中 |
| SentenceInfoEnabled | Integer | 输出断句中间结果标识。1：输出 |
请求示例将同一个音频分成三份分片序号1 请求分片序号2 请求最后分片序号请求
{ "WorkMode":0, "UserVoiceData":"UklGRka1CQBXQVZFZm10IBAAAAABAAEAgD4AAAB9AAACABAATElTVDQAAABJTkZPSU*", "SeqId":1, "IsEnd":0, "RefText":"by bus", "VoiceFileType":3, "VoiceEncodeType":1, "SessionId":"85552f20-6bcb-11ed-a4c1-acde48001122", "EvalMode":1, "ScoreCoeff":1.0}
{ "WorkMode":0, "UserVoiceData":"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA*", "SeqId":2, "IsEnd":0, "RefText":"by bus", "VoiceFileType":3, "VoiceEncodeType":1, "SessionId":"85552f20-6bcb-11ed-a4c1-acde48001122", "EvalMode":1, "ScoreCoeff":1.0}
{ "WorkMode":1, "UserVoiceData":"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA*", "SeqId":3, "IsEnd":1, "RefText":"by bus", "VoiceFileType":3, "VoiceEncodeType":1, "SessionId":"85552f20-6bcb-11ed-a4c1-acde48001122", "EvalMode":1, "ScoreCoeff":1.0}
返回结果
主要返回结果
| 参数名称 | 类型 | 描述 |
| Status | String | 评估 session 状态。Finished：评估完成；Evaluating：评估中 |
返回示例每一次请求都会有响应的结果。只有当 Status 为 Finished 的时候才会最终结果。中间结果1中间结果2最终结果
{ "Response":{ "SuggestedScore":0, "PronAccuracy":0, "PronFluency":-1, "PronCompletion":0, "RequestId":"8c82a721-3163-496b-87a2-9e247159d20f", "Words":[
], "SessionId":"bb0e64c6-6bd3-11ed-9db2-acde48001122", "AudioUrl":"", "SentenceInfoSet":[ { "SuggestedScore":0, "PronAccuracy":0, "PronFluency":-1, "PronCompletion":0, "Words":[
], "SentenceId":-1, "RefTextId":-1, "KeyWordHits":[
], "UnKeyWordHits":[
] } ], "Status":"Evaluating", "RefTextId":-1, "KeyWordHits":[
], "UnKeyWordHits":[
] }}
{ "Response":{ "SuggestedScore":87.23038440298167, "PronAccuracy":98.13418, "PronFluency":0.88928545, "PronCompletion":0.6666667, "RequestId":"6841d14b-1e26-400d-9cfb-7a26914eb67a", "Words":[ { "MemBeginTime":1140, "MemEndTime":1630, "PronAccuracy":96.12227, "PronFluency":0.7536842, "ReferenceWord":"i_0", "Word":"i", "MatchTag":0, "KeywordTag":0, "PhoneInfos":[ { "MemBeginTime":1140, "MemEndTime":1630, "PronAccuracy":96.12227, "DetectedStress":false, "Phone":"ay", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 } ] }, { "MemBeginTime":1660, "MemEndTime":1920, "PronAccuracy":97.68817, "PronFluency":0.9448819, "ReferenceWord":"go_1", "Word":"go", "MatchTag":0, "KeywordTag":0, "PhoneInfos":[ { "MemBeginTime":1660, "MemEndTime":1780, "PronAccuracy":98.64847, "DetectedStress":false, "Phone":"g", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 }, { "MemBeginTime":1780, "MemEndTime":1920, "PronAccuracy":96.72788, "DetectedStress":false, "Phone":"ow", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 } ] }, { "MemBeginTime":1920, "MemEndTime":2180, "PronAccuracy":98.834595, "PronFluency":0.94608915, "ReferenceWord":"to_2", "Word":"to", "MatchTag":0, "KeywordTag":0, "PhoneInfos":[ { "MemBeginTime":1920, "MemEndTime":2020, "PronAccuracy":98.613686, "DetectedStress":false, "Phone":"t", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 }, { "MemBeginTime":2020, "MemEndTime":2180, "PronAccuracy":99.05552, "DetectedStress":false, "Phone":"uw", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 } ] }, { "MemBeginTime":2180, "MemEndTime":2820, "PronAccuracy":98.50996, "PronFluency":0.91248643, "ReferenceWord":"school_3", "Word":"school", "MatchTag":0, "KeywordTag":0, "PhoneInfos":[ { "MemBeginTime":2180, "MemEndTime":2380, "PronAccuracy":98.58907, "DetectedStress":false, "Phone":"s", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 }, { "MemBeginTime":2380, "MemEndTime":2500, "PronAccuracy":98.77323, "DetectedStress":false, "Phone":"k", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 }, { "MemBeginTime":2500, "MemEndTime":2570, "PronAccuracy":98.623055, "DetectedStress":false, "Phone":"uw", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 }, { "MemBeginTime":2570, "MemEndTime":2820, "PronAccuracy":98.05444, "DetectedStress":false, "Phone":"l", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 } ] } ], "SessionId":"bb0e64c6-6bd3-11ed-9db2-acde48001122", "AudioUrl":"", "SentenceInfoSet":[ { "SuggestedScore":0, "PronAccuracy":98.13418, "PronFluency":0.88928545, "PronCompletion":0.6666667, "Words":[ { "MemBeginTime":1140, "MemEndTime":1630, "PronAccuracy":96.12227, "PronFluency":0.7536842, "ReferenceWord":"i_0", "Word":"i", "MatchTag":0, "KeywordTag":0, "PhoneInfos":[ { "MemBeginTime":1140, "MemEndTime":1630, "PronAccuracy":96.12227, "DetectedStress":false, "Phone":"ay", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 } ] }, { "MemBeginTime":1660, "MemEndTime":1920, "PronAccuracy":97.68817, "PronFluency":0.9448819, "ReferenceWord":"go_1", "Word":"go", "MatchTag":0, "KeywordTag":0, "PhoneInfos":[ { "MemBeginTime":1660, "MemEndTime":1780, "PronAccuracy":98.64847, "DetectedStress":false, "Phone":"g", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 }, { "MemBeginTime":1780, "MemEndTime":1920, "PronAccuracy":96.72788, "DetectedStress":false, "Phone":"ow", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 } ] }, { "MemBeginTime":1920, "MemEndTime":2180, "PronAccuracy":98.834595, "PronFluency":0.94608915, "ReferenceWord":"to_2", "Word":"to", "MatchTag":0, "KeywordTag":0, "PhoneInfos":[ { "MemBeginTime":1920, "MemEndTime":2020, "PronAccuracy":98.613686, "DetectedStress":false, "Phone":"t", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 }, { "MemBeginTime":2020, "MemEndTime":2180, "PronAccuracy":99.05552, "DetectedStress":false, "Phone":"uw", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 } ] }, { "MemBeginTime":2180, "MemEndTime":2820, "PronAccuracy":98.50996, "PronFluency":0.91248643, "ReferenceWord":"school_3", "Word":"school", "MatchTag":0, "KeywordTag":0, "PhoneInfos":[ { "MemBeginTime":2180, "MemEndTime":2380, "PronAccuracy":98.58907, "DetectedStress":false, "Phone":"s", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 }, { "MemBeginTime":2380, "MemEndTime":2500, "PronAccuracy":98.77323, "DetectedStress":false, "Phone":"k", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 }, { "MemBeginTime":2500, "MemEndTime":2570, "PronAccuracy":98.623055, "DetectedStress":false, "Phone":"uw", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 }, { "MemBeginTime":2570, "MemEndTime":2820, "PronAccuracy":98.05444, "DetectedStress":false, "Phone":"l", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 } ] } ], "SentenceId":-1, "RefTextId":-1, "KeyWordHits":[
], "UnKeyWordHits":[
] } ], "Status":"Evaluating", "RefTextId":-1, "KeyWordHits":[
], "UnKeyWordHits":[
] }}
{ "Response":{ "SuggestedScore":87.23038440298167, "PronAccuracy":98.13418, "PronFluency":0.88928545, "PronCompletion":0.6666667, "RequestId":"6841d14b-1e26-400d-9cfb-7a26914eb67a", "Words":[ { "MemBeginTime":1140, "MemEndTime":1630, "PronAccuracy":96.12227, "PronFluency":0.7536842, "ReferenceWord":"i_0", "Word":"i", "MatchTag":0, "KeywordTag":0, "PhoneInfos":[ { "MemBeginTime":1140, "MemEndTime":1630, "PronAccuracy":96.12227, "DetectedStress":false, "Phone":"ay", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 } ] }, { "MemBeginTime":1660, "MemEndTime":1920, "PronAccuracy":97.68817, "PronFluency":0.9448819, "ReferenceWord":"go_1", "Word":"go", "MatchTag":0, "KeywordTag":0, "PhoneInfos":[ { "MemBeginTime":1660, "MemEndTime":1780, "PronAccuracy":98.64847, "DetectedStress":false, "Phone":"g", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 }, { "MemBeginTime":1780, "MemEndTime":1920, "PronAccuracy":96.72788, "DetectedStress":false, "Phone":"ow", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 } ] }, { "MemBeginTime":1920, "MemEndTime":2180, "PronAccuracy":98.834595, "PronFluency":0.94608915, "ReferenceWord":"to_2", "Word":"to", "MatchTag":0, "KeywordTag":0, "PhoneInfos":[ { "MemBeginTime":1920, "MemEndTime":2020, "PronAccuracy":98.613686, "DetectedStress":false, "Phone":"t", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 }, { "MemBeginTime":2020, "MemEndTime":2180, "PronAccuracy":99.05552, "DetectedStress":false, "Phone":"uw", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 } ] }, { "MemBeginTime":2180, "MemEndTime":2820, "PronAccuracy":98.50996, "PronFluency":0.91248643, "ReferenceWord":"school_3", "Word":"school", "MatchTag":0, "KeywordTag":0, "PhoneInfos":[ { "MemBeginTime":2180, "MemEndTime":2380, "PronAccuracy":98.58907, "DetectedStress":false, "Phone":"s", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 }, { "MemBeginTime":2380, "MemEndTime":2500, "PronAccuracy":98.77323, "DetectedStress":false, "Phone":"k", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 }, { "MemBeginTime":2500, "MemEndTime":2570, "PronAccuracy":98.623055, "DetectedStress":false, "Phone":"uw", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 }, { "MemBeginTime":2570, "MemEndTime":2820, "PronAccuracy":98.05444, "DetectedStress":false, "Phone":"l", "ReferencePhone":"", "ReferenceLetter":"", "Stress":false, "MatchTag":0 } ] } ], "SessionId":"bb0e64c6-6bd3-11ed-9db2-acde48001122", "AudioUrl":"", "Status":"Evaluating", "RefTextId":-1, "KeyWordHits":[
], "UnKeyWordHits":[
] }}
腾讯云官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠
发表评论