# 语音识别一句话识别接口，用于短语音的同步识别。一次性上传整个音频，响应中即返回识别结果。 ## 请求格式说明 ** 调试工具：** 在线调试

请求方式：POST (HTTPS)

请求地址：

https://open.welink.huaweicloud.com/api/aiservice/v1/sis/short-audio

认证方式： access_token，请参考获取access_token

请求头部：

Content-Type: application/json    
x-wlk-Authorization: access_token

请求参数

{ 
  "config":
  {
    "audio_format": "ulaw8k8bit",
    "property": "chinese_8k_common",
    "add_punc": "yes"
  },
  "data": "/+MgxAAUeHpMAUkQAANhuRAC..."
}

请求参数说明

参数	必选	参数类型	说明
config	是	Object	配置信息。
data	是	String	语音数据，base64编码，要求base64编码后大小不超过4M，音频时长不超过1分钟。

config数据结构

参数	必选	参数类型	说明
audio_format	是	String	支持语音的格式息。
property	是	String	所使用的模型特征串。通常是 “语种采样率领域”的形式。采样率需要与音频采样率保持一致。当前支持如下模型特征串： chinese_8k_common chinese_16k_common
add_punc	否	String	是否加标点，可以为 yes, no(缺省)。
vocabulary_id	否	String	热词表id，不使用则不填写。

audio_format取值范围

参数	说明
pcm16k16bit	16k16bit单通道录音数据。
pcm8k16bit	8k16bit单通道录音数据。
ulaw16k8bit	16k8bit ulaw单通道录音数据。
ulaw8k8bit	8k8bit ulaw单通道录音数据。
alaw16k8bit	16k8bit alaw单通道录音数据。
alaw8k8bit	8k8bit alaw单通道录音数据。
mp3	mp3格式音频。目前仅支持单通道的音频。
aac	aac格式音频。目前仅支持单通道的音频。
wav	带wav封装头的格式，从封装头中自动确定格式，目前仅支持8k/16k采样率、单通道、pcm, alaw, ulaw三种编码格式。
amr	AMR窄带(8k) 压缩录音数据。目前仅支持单通道的音频。
amrwb	AMR 宽带(16k) 压缩录音数据。目前仅支持单通道的音频。

请求示例

 curl -X POST \
  'https://open.welink.huaweicloud.com/api/aiservice/v1/sis/short-audio' \
  -H 'Accept-Charset: UTF-8' \
  -H 'Content-Type: application/json' \
  -H 'x-wlk-Authorization: access_token' \
  -d '{ "config":
          {
            "audio_format": "ulaw8k8bit",
            "property": "chinese_8k_common",
            "add_punc": "yes"
          },
        "data": "/+MgxAAUeHpMAUkQAANhuRAC..."}'

响应格式说明

返回结果 正常返回结果

{
    "code": "0",
    "data": {
        "result": {
            "score": 0,
            "text": ""
        },
        "trace_id": "ad3cc78a-b3b6-4030-8d99-4d43c9c3eaa5"
    },
    "error": "",
    "message": "ok"
}

异常返回结果

失败响应示例

{
    "code": "58401",
    "data": null,
    "error": "Failed to verify the token.",
    "message": "Login authentication failed."
}

返回参数说明 一句话识别响应参数说明请参见表。

响应参数说明

参数	必选	参数类型	说明
code	是	String	错误码
message	是	String	调用成功时为"ok"。调用失败时的错误信息。
data	是	Object	调用成功时表示调用结果，详见data数据结构。调用失败时为null。
error	是	String	错误信息。

data 数据结构

参数	必选	参数类型	说明
trace_id	是	String	服务内部的令牌，可用于在日志中追溯具体流程，调用失败无此字段。在某些错误情况下可能没有此令牌字符串。
result	是	Object	调用成功表识别结果
text	是	String	调用成功表示识别出的内容。
score	是	String	调用成功表示识别出的置信度（0-1之间）。

错误码说明

错误码	说明
0	成功。
58401	无权限。
58402	非法输入参数。
58500	服务异常。
58003	SIS服务异常。

响应格式说明

结果。 ""

无结果。 ""