文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>口语评测（新版）>开发者指南>英文评测模式>情景评测模式

情景评测模式

最近更新时间：2024-11-15 17:59:23

我的收藏

本页目录：

评测模式描述

评测要求：支持不超过30个单词或者汉字，60秒音频时长。
评测维度：支持返回单词精准度，流利度，完整度，切题度。
评测功能：支持原始单词，多组分支，主题词和关键词，关键词组，候选单词数组，负向关键词。

请求参数

主要请求参数说明
参数名称
类型
描述
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_en
eval_mode=5
# 长音频推荐流式
rec_mode=0
# 流式展示中间结果
sentence_info_enabled=1
ref_text="i go to school by bus"
score_coeff=1.000000
voice_format=1

返回结果

主要返回结果如下：
参数名称
类型
描述
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_en
eval_mode=5
# 长音频推荐流式
rec_mode=0
# 流式展示中间结果
sentence_info_enabled=1
ref_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.000000
voice_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_en
eval_mode=5
# 长音频推荐流式
rec_mode=0
# 流式展示中间结果
sentence_info_enabled=1
ref_text="i go to school by @@{::words{bus}, {train},{bike}}"
keyword=""
score_coeff=1.000000
voice_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_en
eval_mode=5
# 长音频推荐流式
rec_mode=0
# 流式展示中间结果
sentence_info_enabled=1
ref_text="i go to school by @@{::words{train}, {bus},{bike}}"
keyword="{::cmd{F_UKEY=true}} bus | train # bike"
score_coeff=1.000000
voice_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
}

中国站
目录