接口说明
更新时间:2021-10-11
语音识别
接口描述
向远程服务上传整段语音进行识别
请求说明
举例:
void asr(aip::Speech client)
{
// 无可选参数调用接口
std::string file_content;
aip::get_file_content("./assets/voice/16k_test.pcm", &file_content);
Json::Value result = client.recognize(file_content, "pcm", 16000, aip::null);
// 极速版调用函数
// Json::Value result = client.recognize_pro(file_content, "pcm", 16000, aip::null);
// 如果需要覆盖或者加入参数
std::map<std::string, std::string> options;
options["dev_pid"] = "1537";
Json::Value result = client.recognize(file_content, "pcm", 16000, options);
}
接口函数说明:
参数 | 类型 | 描述 | 是否必须 |
---|---|---|---|
data | byte[] | 语音二进制数据, 语音文件的格式,pcm 或者 wav 或者 amr。不区分大小写 | 是 |
format | String | 语音文件的格式,pcm 或者 wav 或者 amr。不区分大小写。推荐pcm文件 | 是 |
rate | int | 采样率,16000,固定值 | 是 |
cuid | String | 用户唯一标识,用来区分用户,填写机器 MAC 地址或 IMEI 码,长度为60以内 | 否 |
dev_pid | int | 不填写lan参数生效,都不填写,默认1537(普通话 输入法模型),dev_pid参数见API文档 https://ai.baidu.com/docs#/ASR-API/top | 否 |
lm_id | int | 选填 | 自训练平台模型id,填dev_pid = 8001 或 8002生效 |
语音识别 返回数据参数详情
参数 | 类型 | 是否一定输出 | 描述 |
---|---|---|---|
err_no | int | 是 | 错误码 |
err_msg | int | 是 | 错误码描述 |
sn | int | 是 | 语音数据唯一标识,系统内部产生,用于 debug |
result | int | 是 | 识别结果数组,提供1-5 个候选结果,string 类型为识别的字符串, utf-8 编码 |
dev_pid | 语言 | 模型 | 是否有标点 | 备注 |
---|---|---|---|---|
1537 | 普通话(纯中文识别) | 语音近场识别模型 | 有标点 | 支持自定义词库 |
1737 | 英语 | 无标点 | 不支持自定义词库 | |
1637 | 粤语 | 有标点 | 不支持自定义词库 | |
1837 | 四川话 | 有标点 | 不支持自定义词库 | |
1936 | 普通话远场 | 远场模型 | 有标点 | 不支持 |
返回样例:
// 成功返回
{
"err_no": 0,
"err_msg": "success.",
"corpus_no": "15984125203285346378",
"sn": "481D633F-73BA-726F-49EF-8659ACCC2F3D",
"result": ["北京天气"]
}
// 失败返回
{
"err_no": 2000,
"err_msg": "data empty.",
"sn": null
}