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

单词评测模式

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

我的收藏

本页目录：

评测模式描述

评测要求：支持单词，组合词评测。音频时长最长60秒。
评测维度：支持返回单词精准度，流利度；支持返回音素精准度。
评测功能：支持重音检测，原始单词，音素到字母映射，音素到国际音标转换，指定发音，指定国际音标。

请求参数

主要请求参数说明：
参数名称
类型
描述
ref_text
String
被评估文本。支持单词，组合词，缩写
eval_mode
Integer
评估模式。0：单词评测模式
请求示例

# 参数示例为websocket连接URL展开, 如：soe.cloud.tencent.com/soe/api/1306***?eval_mode=0&voice_format=1&...
server_engine_type=16k_en
eval_mode=0
rec_mode=0
ref_text"father"
score_coeff=1.000000
sentence_info_enabled=0
text_mode=0
voice_format=1

返回结果

主要返回结果说明：
参数名称
类型
描述
SuggestedScore
Float
建议评分
PronAccuracy
Float
整体精准度
PronFluency
Float
整体流利度
Words.PronAccuracy
Float
单词精准度
Words.PronFluency
Float
单词流利度
Words.PhoneInfos.PronAccuracy
Float
音素精准度
Words.PhoneInfos.Stress
Boolean
当前评估文本对应音素是否为重音
Words.PhoneInfos.DetectedStress
Boolean
当前音频数据对应音素是否为重音
返回示例
{
    "code": 0,
    "message": "af31ab3f-9a5e-4a90-b17f-a5869b7c326a_1",
    "voice_id": "af31ab3f-9a5e-4a90-b17f-a5869b7c326a",
    "result": {
        "SuggestedScore": 98.04969787597656,
        "PronAccuracy": 98.04969787597656,
        "PronFluency": 0.8466556668281555,
        "PronCompletion": 1,
        "Words": [
            {
                "MemBeginTime": 390,
                "MemEndTime": 1370,
                "PronAccuracy": 98.04969787597656,
                "PronFluency": 0.8466556668281555,
                "ReferenceWord": "father_0",
                "Word": "father",
                "MatchTag": 0,
                "KeywordTag": 0,
                "PhoneInfos": [
                    {
                        "MemBeginTime": 390,
                        "MemEndTime": 550,
                        "PronAccuracy": 96.76220703125,
                        "DetectedStress": false,
                        "Phone": "f",
                        "ReferencePhone": "",
                        "ReferenceLetter": "",
                        "Stress": false,
                        "MatchTag": 0
                    },
                    {
                        "MemBeginTime": 550,
                        "MemEndTime": 810,
                        "PronAccuracy": 97.25521850585938,
                        "DetectedStress": false,
                        "Phone": "aa",
                        "ReferencePhone": "",
                        "ReferenceLetter": "",
                        "Stress": false,
                        "MatchTag": 0
                    },
                    {
                        "MemBeginTime": 810,
                        "MemEndTime": 930,
                        "PronAccuracy": 99.20626068115234,
                        "DetectedStress": false,
                        "Phone": "dh",
                        "ReferencePhone": "",
                        "ReferenceLetter": "",
                        "Stress": false,
                        "MatchTag": 0
                    },
                    {
                        "MemBeginTime": 930,
                        "MemEndTime": 1370,
                        "PronAccuracy": 98.97508239746094,
                        "DetectedStress": false,
                        "Phone": "er",
                        "ReferencePhone": "",
                        "ReferenceLetter": "",
                        "Stress": false,
                        "MatchTag": 0
                    }
                ],
                "Tone": {
                    "Valid": false,
                    "RefTone": -1,
                    "HypothesisTone": -1
                }
            }
        ],
        "SentenceId": -1,
        "RefTextId": -1,
        "KeyWordHits": null,
        "UnKeyWordHits": null
    },
    "final": 1
}

原始单词

数字类型使用英文评测会转换为对应英文单词，可在对应返回字段获取原始数字以及单词下标。

请求参数

主要请求参数说明：
参数名称
类型
描述
ref_text
String
被评估文本
eval_mode
Integer
评估模式。0：单词评测模式
请求示例
# 参数示例为websocket连接URL展开, 如：soe.cloud.tencent.com/soe/api/1306***?eval_mode=0&voice_format=1&...
server_engine_type=16k_en
eval_mode=0
keyword=
rec_mode=0
ref_text"1"
score_coeff=1.000000
sentence_info_enabled=0
text_mode=0
voice_format=1

返回结果

主要返回结果说明：
参数名称
类型
描述
Words.Word
String
当前词
Words.ReferenceWord
String
原始单词
返回示例
{
    "code": 0,
    "message": "d91a2d4e-73c0-492f-89d1-115059453d87_1",
    "voice_id": "d91a2d4e-73c0-492f-89d1-115059453d87",
    "result": {
        "SuggestedScore": 97.94207763671875,
        "PronAccuracy": 97.94207763671875,
        "PronFluency": 0.9294439554214478,
        "PronCompletion": 1,
        "Words": [
            {
                "MemBeginTime": 210,
                "MemEndTime": 690,
                "PronAccuracy": 97.94207763671875,
                "PronFluency": 0.9294439554214478,
                "ReferenceWord": "1_0",
                "Word": "one",
                "MatchTag": 0,
                "KeywordTag": 0,
                "PhoneInfos": [
                    {
                        "MemBeginTime": 210,
                        "MemEndTime": 290,
                        "PronAccuracy": 97.15730285644531,
                        "DetectedStress": false,
                        "Phone": "hh",
                        "ReferencePhone": "",
                        "ReferenceLetter": "",
                        "Stress": false,
                        "MatchTag": 0
                    },
                    {
                        "MemBeginTime": 290,
                        "MemEndTime": 390,
                        "PronAccuracy": 97.685546875,
                        "DetectedStress": false,
                        "Phone": "w",
                        "ReferencePhone": "",
                        "ReferenceLetter": "",
                        "Stress": false,
                        "MatchTag": 0
                    },
                    {
                        "MemBeginTime": 390,
                        "MemEndTime": 550,
                        "PronAccuracy": 98.44290924072266,
                        "DetectedStress": false,
                        "Phone": "ah",
                        "ReferencePhone": "",
                        "ReferenceLetter": "",
                        "Stress": false,
                        "MatchTag": 0
                    },
                    {
                        "MemBeginTime": 550,
                        "MemEndTime": 690,
                        "PronAccuracy": 98.48255920410156,
                        "DetectedStress": false,
                        "Phone": "n",
                        "ReferencePhone": "",
                        "ReferenceLetter": "",
                        "Stress": false,
                        "MatchTag": 0
                    }
                ],
                "Tone": {
                    "Valid": false,
                    "RefTone": -1,
                    "HypothesisTone": -1
                }
            }
        ],
        "SentenceId": -1,
        "RefTextId": -1,
        "KeyWordHits": null,
        "UnKeyWordHits": null
    },
    "final": 1
}

音素到字母映射

通过该功能，可以对音素映射字母进行标记。音素到字母映射结构：{::cmd{F_P2L=true}} + 评估文本。

请求参数

主要请求参数说明：
参数名称
类型
描述
ref_text
String
被评估文本。
eval_mode
Integer
评估模式。0：单词评测模式
请求示例
# 参数示例为websocket连接URL展开, 如：soe.cloud.tencent.com/soe/api/1306***?eval_mode=0&voice_format=1&...
server_engine_type=16k_en
eval_mode=0
keyword=
rec_mode=0
ref_text"{::cmd{F_P2L=true}} happy"
score_coeff=1.000000
sentence_info_enabled=0
text_mode=0
voice_format=1

返回结果

主要返回结果说明：
参数名称
类型
描述
Words.Word
String
当前单词
Words.PhoneInfos.Phone
String
当前单词的音素
Words.PhoneInfos.ReferenceLetter
String
当前单词的音素映射的字母
返回示例

{
    "code": 0,
    "message": "4984a513-e57f-4345-a926-df0298fd3a04_1",
    "voice_id": "4984a513-e57f-4345-a926-df0298fd3a04",
    "result": {
        "SuggestedScore": 94.5397720336914,
        "PronAccuracy": 94.5397720336914,
        "PronFluency": 0.9604969024658203,
        "PronCompletion": 1,
        "Words": [
            {
                "MemBeginTime": 200,
                "MemEndTime": 650,
                "PronAccuracy": 94.5397720336914,
                "PronFluency": 0.9604969024658203,
                "ReferenceWord": "happy_0",
                "Word": "happy",
                "MatchTag": 0,
                "KeywordTag": 0,
                "PhoneInfos": [
                    {
                        "MemBeginTime": 200,
                        "MemEndTime": 260,
                        "PronAccuracy": 82.32677459716797,
                        "DetectedStress": false,
                        "Phone": "hh",
                        "ReferencePhone": "",
                        "ReferenceLetter": "h_0",
                        "Stress": false,
                        "MatchTag": 0
                    },
                    {
                        "MemBeginTime": 260,
                        "MemEndTime": 340,
                        "PronAccuracy": 97.87178039550781,
                        "DetectedStress": false,
                        "Phone": "ae",
                        "ReferencePhone": "",
                        "ReferenceLetter": "a_1",
                        "Stress": false,
                        "MatchTag": 0
                    },
                    {
                        "MemBeginTime": 340,
                        "MemEndTime": 420,
                        "PronAccuracy": 99.12616729736328,
                        "DetectedStress": false,
                        "Phone": "p",
                        "ReferencePhone": "",
                        "ReferenceLetter": "pp_2",
                        "Stress": false,
                        "MatchTag": 0
                    },
                    {
                        "MemBeginTime": 420,
                        "MemEndTime": 650,
                        "PronAccuracy": 98.83436584472656,
                        "DetectedStress": false,
                        "Phone": "iy",
                        "ReferencePhone": "",
                        "ReferenceLetter": "y_4",
                        "Stress": false,
                        "MatchTag": 0
                    }
                ],
                "Tone": {
                    "Valid": false,
                    "RefTone": -1,
                    "HypothesisTone": -1
                }
            }
        ],
        "SentenceId": -1,
        "RefTextId": -1,
        "KeyWordHits": null,
        "UnKeyWordHits": null
    },
    "final": 1
}

音素到国际音标转换

返回音素默认为智聆音素，使用 {::cmd{F_IPA=true}} + 单词 开启⾳素到国际⾳标转换功能。

请求参数

主要请求参数说明：
参数名称
类型
描述
ref_text
String
被评估文本。
eval_mode
Integer
评估模式。0：单词评测模式
请求示例
# 参数示例为websocket连接URL展开, 如：soe.cloud.tencent.com/soe/api/1306***?eval_mode=0&voice_format=1&...
server_engine_type=16k_en
eval_mode=0
keyword=
rec_mode=0
ref_text"{::cmd{F_IPA=true}} happy"
score_coeff=1.000000
sentence_info_enabled=0
text_mode=0
voice_format=1

返回结果

返回结果说明：
参数名称
类型
描述
Words.PhoneInfos.Phone
String
当前音节
返回示例
{
    "code": 0,
    "message": "3b651764-c4b4-4786-a8df-5f993aee34a8_1",
    "voice_id": "3b651764-c4b4-4786-a8df-5f993aee34a8",
    "result": {
        "SuggestedScore": 94.5397720336914,
        "PronAccuracy": 94.5397720336914,
        "PronFluency": 0.9604969024658203,
        "PronCompletion": 1,
        "Words": [
            {
                "MemBeginTime": 200,
                "MemEndTime": 650,
                "PronAccuracy": 94.5397720336914,
                "PronFluency": 0.9604969024658203,
                "ReferenceWord": "happy_0",
                "Word": "happy",
                "MatchTag": 0,
                "KeywordTag": 0,
                "PhoneInfos": [
                    {
                        "MemBeginTime": 200,
                        "MemEndTime": 260,
                        "PronAccuracy": 82.32677459716797,
                        "DetectedStress": false,
                        "Phone": "'h",
                        "ReferencePhone": "",
                        "ReferenceLetter": "",
                        "Stress": false,
                        "MatchTag": 0
                    },
                    {
                        "MemBeginTime": 260,
                        "MemEndTime": 340,
                        "PronAccuracy": 97.87178039550781,
                        "DetectedStress": false,
                        "Phone": "æ",
                        "ReferencePhone": "",
                        "ReferenceLetter": "",
                        "Stress": false,
                        "MatchTag": 0
                    },
                    {
                        "MemBeginTime": 340,
                        "MemEndTime": 420,
                        "PronAccuracy": 99.12616729736328,
                        "DetectedStress": false,
                        "Phone": "p",
                        "ReferencePhone": "",
                        "ReferenceLetter": "",
                        "Stress": false,
                        "MatchTag": 0
                    },
                    {
                        "MemBeginTime": 420,
                        "MemEndTime": 650,
                        "PronAccuracy": 98.83436584472656,
                        "DetectedStress": false,
                        "Phone": "i",
                        "ReferencePhone": "",
                        "ReferenceLetter": "",
                        "Stress": false,
                        "MatchTag": 0
                    }
                ],
                "Tone": {
                    "Valid": false,
                    "RefTone": -1,
                    "HypothesisTone": -1
                }
            }
        ],
        "SentenceId": -1,
        "RefTextId": -1,
        "KeyWordHits": null,
        "UnKeyWordHits": null
    },
    "final": 1
}

指定发音

使用 单词{::pron{p1,p2..},{p3,p4..}..} 指定发音，需要将国际音标通过音素映射表转换为智聆音素，参考音素映射表 -- 智聆音素。

请求参数

主要请求参数说明：
参数名称
类型
描述
ref_text
String
被评估文本。
eval_mode
Integer
评估模式。0：单词评测模式
请求示例
音标
单词
多音词
# 参数示例为websocket连接URL展开, 如：soe.cloud.tencent.com/soe/api/1306***?eval_mode=0&voice_format=1&...
server_engine_type=16k_en
eval_mode=0
keyword=
rec_mode=0
ref_text"au{::pron{aw}}"
score_coeff=1.000000
sentence_info_enabled=0
text_mode=0
voice_format=1
server_engine_type=16k_en
eval_mode=0
keyword=
rec_mode=0
ref_text"happy{::pron{hh,ae,p,iy}}"
score_coeff=1.000000
sentence_info_enabled=0
text_mode=0
voice_format=1
server_engine_type=16k_en
eval_mode=0
keyword=
rec_mode=0
ref_text"use{::pron{y,uw,z},{y,uw,s}}"
score_coeff=1.000000
sentence_info_enabled=0
text_mode=0
voice_format=1

返回结果

主要返回结果说明：
参数名称
类型
描述
SuggestedScore
Float
建议评分
PronAccuracy
Float
整体精准度
PronFluency
Float
整体流利度
Words.PronAccuracy
Float
单词精准度
Words.PronFluency
Float
单词流利度
Words.PhoneInfos.PronAccuracy
Float
音素精准度
返回示例
{
    "code": 0,
    "message": "9339be72-4799-4bbb-8e6d-e8148f45f2d9_1",
    "voice_id": "9339be72-4799-4bbb-8e6d-e8148f45f2d9",
    "result": {
        "SuggestedScore": 94.50332641601562,
        "PronAccuracy": 94.50332641601562,
        "PronFluency": 0.9472841620445251,
        "PronCompletion": 1,
        "Words": [
            {
                "MemBeginTime": 130,
                "MemEndTime": 650,
                "PronAccuracy": 94.50332641601562,
                "PronFluency": 0.9472841620445251,
                "ReferenceWord": "happy_0",
                "Word": "happy",
                "MatchTag": 0,
                "KeywordTag": 0,
                "PhoneInfos": [
                    {
                        "MemBeginTime": 130,
                        "MemEndTime": 260,
                        "PronAccuracy": 82.18097686767578,
                        "DetectedStress": false,
                        "Phone": "hh",
                        "ReferencePhone": "",
                        "ReferenceLetter": "",
                        "Stress": false,
                        "MatchTag": 0
                    },
                    {
                        "MemBeginTime": 260,
                        "MemEndTime": 340,
                        "PronAccuracy": 97.87178039550781,
                        "DetectedStress": false,
                        "Phone": "ae",
                        "ReferencePhone": "",
                        "ReferenceLetter": "",
                        "Stress": false,
                        "MatchTag": 0
                    },
                    {
                        "MemBeginTime": 340,
                        "MemEndTime": 420,
                        "PronAccuracy": 99.12616729736328,
                        "DetectedStress": false,
                        "Phone": "p",
                        "ReferencePhone": "",
                        "ReferenceLetter": "",
                        "Stress": false,
                        "MatchTag": 0
                    },
                    {
                        "MemBeginTime": 420,
                        "MemEndTime": 650,
                        "PronAccuracy": 98.83436584472656,
                        "DetectedStress": false,
                        "Phone": "iy",
                        "ReferencePhone": "",
                        "ReferenceLetter": "",
                        "Stress": false,
                        "MatchTag": 0
                    }
                ],
                "Tone": {
                    "Valid": false,
                    "RefTone": -1,
                    "HypothesisTone": -1
                }
            }
        ],
        "SentenceId": -1,
        "RefTextId": -1,
        "KeyWordHits": null,
        "UnKeyWordHits": null
    },
    "final": 1
}


指定国际音标

使用 单词{::ipapron{p1,p2..},{p3,p4..}..} 指定国际音标参考，音素映射表 -- 国际音标。指定国际音标并不会返回国际音标，如需返回国际音标需要添加音素到国际音标转换。

请求参数

主要请求参数说明：
参数名称
类型
描述
ref_text
String
被评估文本。
eval_mode
Integer
评估模式。0：单词评测模式
请求示例
音标
单词
多音词
国际音标指定+转换
# 参数示例为websocket连接URL展开, 如：soe.cloud.tencent.com/soe/api/1306***?eval_mode=0&voice_format=1&...
server_engine_type=16k_en
eval_mode=0
keyword=
rec_mode=0
ref_text"au{::ipapron{aʊ}}"
score_coeff=1.000000
sentence_info_enabled=0
text_mode=0
voice_format=1
voice_id=6bd18918-8d15-4272-b693-6c588f058a33
server_engine_type=16k_en
eval_mode=0
keyword=
rec_mode=0
ref_text"happy{::ipapron{'h,æ,p,i}}"
score_coeff=1.000000
sentence_info_enabled=0
text_mode=0
voice_format=1
voice_id=6bd18918-8d15-4272-b693-6c588f058a33
server_engine_type=16k_en
eval_mode=0
keyword=
rec_mode=0
ref_text"use{::ipapron{j,u,z},{j,u,s}}"
score_coeff=1.000000
sentence_info_enabled=0
text_mode=0
voice_format=1
voice_id=6bd18918-8d15-4272-b693-6c588f058a33
server_engine_type=16k_en
eval_mode=0
keyword=
rec_mode=0
ref_text"{::cmd{F_IPA=true}}happy{::ipapron{'h,æ,p,i}}"
score_coeff=1.000000
sentence_info_enabled=0
text_mode=0
voice_format=1
voice_id=6bd18918-8d15-4272-b693-6c588f058a33

返回结果

主要返回结果说明：
参数名称
类型
描述
SuggestedScore
Float
建议评分
PronAccuracy
Float
整体精准度
PronFluency
Float
整体流利度
Words.PronAccuracy
Float
单词精准度
Words.PronFluency
Float
单词流利度
Words.PhoneInfos.PronAccuracy
Float
音素精准度
返回示例
{
    "code": 0,
    "message": "70e2b951-fd1c-4b9a-b66f-935150e24da2_1",
    "voice_id": "70e2b951-fd1c-4b9a-b66f-935150e24da2",
    "result": {
        "SuggestedScore": 94.50332641601562,
        "PronAccuracy": 94.50332641601562,
        "PronFluency": 0.9472841620445251,
        "PronCompletion": 1,
        "Words": [
            {
                "MemBeginTime": 130,
                "MemEndTime": 650,
                "PronAccuracy": 94.50332641601562,
                "PronFluency": 0.9472841620445251,
                "ReferenceWord": "happy_0",
                "Word": "happy",
                "MatchTag": 0,
                "KeywordTag": 0,
                "PhoneInfos": [
                    {
                        "MemBeginTime": 130,
                        "MemEndTime": 260,
                        "PronAccuracy": 82.18097686767578,
                        "DetectedStress": false,
                        "Phone": "'h",
                        "ReferencePhone": "",
                        "ReferenceLetter": "",
                        "Stress": false,
                        "MatchTag": 0
                    },
                    {
                        "MemBeginTime": 260,
                        "MemEndTime": 340,
                        "PronAccuracy": 97.87178039550781,
                        "DetectedStress": false,
                        "Phone": "æ",
                        "ReferencePhone": "",
                        "ReferenceLetter": "",
                        "Stress": false,
                        "MatchTag": 0
                    },
                    {
                        "MemBeginTime": 340,
                        "MemEndTime": 420,
                        "PronAccuracy": 99.12616729736328,
                        "DetectedStress": false,
                        "Phone": "p",
                        "ReferencePhone": "",
                        "ReferenceLetter": "",
                        "Stress": false,
                        "MatchTag": 0
                    },
                    {
                        "MemBeginTime": 420,
                        "MemEndTime": 650,
                        "PronAccuracy": 98.83436584472656,
                        "DetectedStress": false,
                        "Phone": "i",
                        "ReferencePhone": "",
                        "ReferenceLetter": "",
                        "Stress": false,
                        "MatchTag": 0
                    }
                ],
                "Tone": {
                    "Valid": false,
                    "RefTone": -1,
                    "HypothesisTone": -1
                }
            }
        ],
        "SentenceId": -1,
        "RefTextId": -1,
        "KeyWordHits": null,
        "UnKeyWordHits": null
    },
    "final": 1
}

中国站
目录