文档反馈官招募中，报名立赚积分兑换代金券！> 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_zh
eval_mode=5
ref_text="油画 | 山水画作"
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": "4b1c4ba9-356c-490d-bd5a-757c6780e565_8",
    "voice_id": "4b1c4ba9-356c-490d-bd5a-757c6780e565",
    "result": {
        "SuggestedScore": 98.82364654541016,
        "PronAccuracy": 98.82364654541016,
        "PronFluency": 0.9782572984695435,
        "PronCompletion": 1,
        "Words": [
            {
                "MemBeginTime": 150,
                "MemEndTime": 530,
                "PronAccuracy": 98.3575439453125,
                "PronFluency": 0.9699531197547913,
                "ReferenceWord": "",
                "Word": "山",
                "MatchTag": 0,
                "KeywordTag": 0,
                "PhoneInfos": [

                ],
                "Tone": {
                    "Valid": false,
                    "RefTone": -1,
                    "HypothesisTone": -1
                }
            },
            {
                "MemBeginTime": 530,
                "MemEndTime": 700,
                "PronAccuracy": 98.8291244506836,
                "PronFluency": 1,
                "ReferenceWord": "",
                "Word": "水",
                "MatchTag": 0,
                "KeywordTag": 0,
                "PhoneInfos": [

                ],
                "Tone": {
                    "Valid": false,
                    "RefTone": -1,
                    "HypothesisTone": -1
                }
            },
            {
                "MemBeginTime": 700,
                "MemEndTime": 940,
                "PronAccuracy": 99.136474609375,
                "PronFluency": 0.9950633645057678,
                "ReferenceWord": "",
                "Word": "画",
                "MatchTag": 0,
                "KeywordTag": 0,
                "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": 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_zh
eval_mode=5
ref_text="油画 | 山水画作"
keyword="油 | 山水画 | 绘画"
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": "617cc654-4c70-49c1-88e2-bb5f5c496443_8",
    "voice_id": "617cc654-4c70-49c1-88e2-bb5f5c496443",
    "result": {
        "SuggestedScore": 98.82364654541016,
        "PronAccuracy": 98.82364654541016,
        "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": [
            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_zh
eval_mode=5
ref_text="油画 | 山水画作"
keyword="油 | 山水画 | 绘画"
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": "ad96a3d8-03d6-4a44-b34f-0c1324d290af_8",
    "voice_id": "ad96a3d8-03d6-4a44-b34f-0c1324d290af",
    "result": {
        "SuggestedScore": 82.9704818725586,
        "PronAccuracy": 98.77437591552734,
        "PronFluency": 0.9883387684822083,
        "PronCompletion": 0.6000000238418579,
        "Words": [
            {
                "MemBeginTime": -1,
                "MemEndTime": -1,
                "PronAccuracy": -1,
                "PronFluency": -1,
                "ReferenceWord": "",
                "Word": "一",
                "MatchTag": 2,
                "KeywordTag": 0,
                "PhoneInfos": [

                ],
                "Tone": {
                    "Valid": false,
                    "RefTone": -1,
                    "HypothesisTone": -1
                }
            },
            {
                "MemBeginTime": -1,
                "MemEndTime": -1,
                "PronAccuracy": -1,
                "PronFluency": -1,
                "ReferenceWord": "",
                "Word": "幅",
                "MatchTag": 2,
                "KeywordTag": 0,
                "PhoneInfos": [

                ],
                "Tone": {
                    "Valid": false,
                    "RefTone": -1,
                    "HypothesisTone": -1
                }
            },
            {
                "MemBeginTime": 150,
                "MemEndTime": 530,
                "PronAccuracy": 98.3575439453125,
                "PronFluency": 0.9699531197547913,
                "ReferenceWord": "",
                "Word": "山",
                "MatchTag": 0,
                "KeywordTag": 0,
                "PhoneInfos": [

                ],
                "Tone": {
                    "Valid": false,
                    "RefTone": -1,
                    "HypothesisTone": -1
                }
            },
            {
                "MemBeginTime": 530,
                "MemEndTime": 700,
                "PronAccuracy": 98.8291244506836,
                "PronFluency": 1,
                "ReferenceWord": "",
                "Word": "水",
                "MatchTag": 0,
                "KeywordTag": 0,
                "PhoneInfos": [

                ],
                "Tone": {
                    "Valid": false,
                    "RefTone": -1,
                    "HypothesisTone": -1
                }
            },
            {
                "MemBeginTime": 700,
                "MemEndTime": 940,
                "PronAccuracy": 99.136474609375,
                "PronFluency": 0.9950633645057678,
                "ReferenceWord": "",
                "Word": "画",
                "MatchTag": 0,
                "KeywordTag": 0,
                "PhoneInfos": [

                ],
                "Tone": {
                    "Valid": false,
                    "RefTone": -1,
                    "HypothesisTone": -1
                }
            },
            {
                "MemBeginTime": -1,
                "MemEndTime": -1,
                "PronAccuracy": -1,
                "PronFluency": -1,
                "ReferenceWord": "*",
                "Word": "*",
                "MatchTag": 1,
                "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_zh
eval_mode=5
ref_text="油画 | 山水画作"
keyword="{::cmd{F_UKEY=true}} 画 | 山水画 # 绘画"
score_coeff=1.000000
voice_format=1

返回结果

主要返回结果
参数名称
类型
描述
UnKeyWordHits
Array of Float
负向主题词命中标志
返回示例
{
    "code": 0,
    "message": "c30502e6-7289-4c5d-8b3a-b72a6a16a0d3_8",
    "voice_id": "c30502e6-7289-4c5d-8b3a-b72a6a16a0d3",
    "result": {
        "SuggestedScore": 0,
        "PronAccuracy": 0,
        "PronFluency": -1,
        "PronCompletion": -1,
        "Words": [

        ],
        "SentenceId": -1,
        "RefTextId": -1,
        "KeyWordHits": null,
        "UnKeyWordHits": [
            1
        ]
    },
    "final": 1
}

指定发音

使用 汉字{::pron{p1,p2..},{p3,p4..}..} 指定发音，发音单元为 拼音。

请求参数

主要请求参数说明
参数名称
类型
描述
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_zh
eval_mode=5
ref_text="清平乐{::pron{yue4}}"
score_coeff=1.000000
voice_format=1

返回结果

主要返回结果说明
参数名称
类型
描述
SuggestedScore
Float
建议评分
PronAccuracy
Float
整体精准度
PronFluency
Float
整体流利度
Words.PronAccuracy
Float
单词精准度
Words.PronFluency
Float
单词流利度
返回示例
{
    "code": 0,
    "message": "d5f712e6-2e10-4ed4-af97-07f35ad96a07_6",
    "voice_id": "d5f712e6-2e10-4ed4-af97-07f35ad96a07",
    "result": {
        "SuggestedScore": 98.83511352539062,
        "PronAccuracy": 98.83511352539062,
        "PronFluency": 0.9852638244628906,
        "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": 730,
                "PronAccuracy": 98.99861145019531,
                "PronFluency": 1,
                "ReferenceWord": "",
                "Word": "平",
                "MatchTag": 0,
                "KeywordTag": 0,
                "PhoneInfos": [

                ],
                "Tone": {
                    "Valid": false,
                    "RefTone": -1,
                    "HypothesisTone": -1
                }
            },
            {
                "MemBeginTime": 730,
                "MemEndTime": 1070,
                "PronAccuracy": 98.82843780517578,
                "PronFluency": 0.96946781873703,
                "ReferenceWord": "",
                "Word": "乐",
                "MatchTag": 0,
                "KeywordTag": 0,
                "PhoneInfos": [

                ],
                "Tone": {
                    "Valid": false,
                    "RefTone": -1,
                    "HypothesisTone": -1
                }
            }
        ],
        "SentenceId": -1,
        "RefTextId": 0,
        "KeyWordHits": null,
        "UnKeyWordHits": null
    },
    "final": 1
}






中国站
目录