1. 接口说明

语音评测接口通过智能语音技术自动对发音水平进行评价，包括：中文普通话发音水平自动评测技术、英文发音水平自动评测技术。请注意不支持自由说模式，需指定试题文本。试题格式，请点击 试题格式 查看详情。

语音评测有以下高阶功能，需开通相应的高阶权限后才可以使用。开通请到控制台-我的应用-语音评测处点击“申请购买”，与商务人员取得联系。

该接口是通过HTTP API的方式给开发者提供一个通用的接口，适用于一次性交互数据传输的AI服务场景，即将音频一次性发送至云端，块式传输。相较于SDK，API具有轻量、跨语言的特点，不过请注意该接口使用的HTTP API协议不支持跨域。

2. 接口Demo

示例demo 请点击 这里 下载。目前仅提供部分开发语言的demo，其他语言请参照下方接口文档进行开发。也欢迎热心的开发者到 讯飞开放平台社区 分享你们的demo。

3. 接口要求

集成语音评测API时，需按照以下要求。

4. 接口调用流程

采用通用的接口调用流程，详细请参照 接口描述 。

接口地址示例

POST http[s]://api.xfyun.cn/v1/service/v1/ise HTTP/1.1
Content-Type:application/x-www-form-urlencoded; charset=utf-8

5. 接口请求参数

5.1. Header参数

在 Http Request Header 中配置授权认证参数，见【接口描述-授权认证】。其中 X-Param 为各配置参数组成的 JSON 串经 BASE64 编码之后的字符串，原始 JSON 串各字段说明如下：

X-Param生成示例：

原始JSON串：
{
    "aue": "raw",
    "result_level": "simple",
    "language": "en_us",
    "category": "read_sentence"
}
BASE64编码（即X-Param）：
eyJhdWUiOiAicmF3IiwicmVzdWx0X2xldmVsIjogInNpbXBsZSIsImxhbmd1YWdlIjogImVuX3VzIiwiY2F0ZWdvcnkiOiAicmVhZF9zZW50ZW5jZSJ9

5.2. Body参数

在 Http Request Body 中配置以下参数：

注： 音频数据 base64 编码后大小会增加约1/3。

6. 接口返回参数

返回值为 json 串，各字段如下：

其中 sid 字段主要用于追查问题，如果出现问题，可以提供 sid 给讯飞技术人员帮助确认问题。data 即评测结果，其格式及字段含义详见 语音评测结果说明 文档。

示例如下：

失败：

{
    "code": "10106",
    "desc": "invalid parameter|invalid X-Appid",
    "data": "",
    "sid": "wse0000bb3f@ch3d5c059d83b3477200"
}

成功：

{
"data":{
    "read_word":{
        "lan":"en",
        "type":"study",
        "version":"6.5.0.1011",
        "rec_paper":{
            "read_word":{
                "except_info":"28680",
                "is_rejected":"false",
                "total_score":"64.725080",
                "sentence":[
                    {
                        "beg_pos":"0",
                        "content":"apple",
                        "end_pos":"129",
                        "word":{
                            "beg_pos":"79",
                            "content":"apple",
                            "end_pos":"129",
                            "total_score":"94.963020"
                        }
                    },
                    {
                        "beg_pos":"129",
                        "content":"banana",
                        "end_pos":"163",
                        "word":{
                            "beg_pos":"163",
                            "content":"banana",
                            "end_pos":"163",
                            "total_score":"0.000000"
                        }
                    },
                    {
                        "beg_pos":"163",
                        "content":"orange",
                        "end_pos":"226",
                        "word":{
                            "beg_pos":"163",
                            "content":"orange",
                            "end_pos":"226",
                            "total_score":"99.212200"
                        }
                    },
                    {
                        "content":"banana",
                        "end_pos":"359",
                        "word":{
                            "beg_pos":"265",
                            "content":"banana",
                            "end_pos":"318"
                        },
                        "beg_pos":"226"
                    }
                ],
                "beg_pos":"0",
                "content":"apple banana orange",
                "end_pos":"359"
            }
        }
    }
},
"code":"0",
"desc":"success",
"sid":"wse00000001@ll36940e324c59000100"
}

7. 试题格式

试题格式示例及注意事项如下：

1. 中英文试题长度要求中文不超过180字符、英文不超过300字符，超出会报错10109（text is too long）。如需解除（建议中英文字词不要超过400，中文句篇不要超过2000，英文句篇不要超过1024），请到控制台-我的应用-语音评测处点击“申请购买”，与商务人员取得联系。2. 中文拼音标注试卷1）以<customizer:interphonic>开头，单独一行。2）字单独一行，紧接着的一行为字的拼音3）拼音后加数字代表声调，1-4分别代表一到四声，5表示轻声4）多个拼音之间用 “|” 隔开3. 字词纯文本试卷多个字或者词之间用逗号隔开4. 英文词一个单词占一行，首行用[word]标记，单个单词长度应不大于32字节。5. 中英文篇章（需开通篇章权限）每句不能超过100个字节。请不要遗漏标点符号，且句子之间需要有标点符号，如：分句，逗号，问号，句号，感叹号等。

8. 全维度说明

开通方法：请到控制台-我的应用-语音评测处点击“申请购买”，与商务人员取得联系。使用方法：extra_ability = multi_dimension使用说明：开通全维度权限前后可获得的结果对比如下，红色为开通全维度以后才会返回的评分维度，返回结果各字段的详细说明请点击 语音评测结果说明 查看。

注：中文声韵分：指声母和韵母正确率的得分。中文调型分：指声调正确率的得分。

9. 调用示例

注： 运行demo返回的结果中的 data 即评测结果，其格式及字段含义详见 语音评测结果说明

语音评测demo go语言

语音评测demo php语言

语音评测demo java语言

语音评测demo python3语言

语音评测demo c#语言

10. 试题及音频样例

语音评测 试题及音频样例 下载

注： 音频文件格式转换工具以及讯飞定制SPEEX编码工具请参考这里 音频格式说明

Copyright © iflytek.com 2018 all right reserved，powered by Gitbook该文件修订时间：2019-05-07 07:12:51