文档中心 > 步骤3:发送请求
步骤3:发送请求

最近更新时间:2021-06-22

本节以语音识别为例,将音频转变为特定的文本。通过Token认证方式调用语音识别的API请求。

1 请求说明

1.1 请求方式

调用地址:https://apim.unicloud.com/api/speech/asrsentence/1.0.0/

请求方式:POST

返回类型:JSON

1.2 请求参数

Header如下:

参数是否必选类型可选值范围说明
Content-Typetruestringapplication/json--
AuthorizationtruestringBearer--
audio-formattruestring--音频编码格式,支持pcm, wav
sample-ratetrueint--音频采样率,支持8000,16000
add-pctfalsebool--是否在短静音处添加标点,默认false,即整段文本不添加标点符号
enable-itnfalsebool--是否在后处理中执行ITN(逆文本标准化),默认false
domainfalsestring--应用所属领域,如导航、客服等,以数字进行编码,默认值固定为1

Body为二进制音频数据 。

1.3 请求示例

curl --location --request POST 'https://apim.unicloud.com/api/speech/asrsentence/1.0.0/' \
--header 'audio-format: wav' \
--header 'sample-rate: 16000' \
--header 'add-pct: false' \
--header 'Content-Type: text/plain' \
--header 'Authorization:Bearer 2735fbc9-b797-31ad-812c-d8e9e903f6e3' \
--data-binary '@wk.wav'

注:发送请求时,Token请填写“步骤2:创建应用”后得到的Token

2 返回说明

2.1 返回参数

字段类型说明
dataobject返回结果数据
+trace_idstring任务id
+textstring语音识别结果,失败时为空
messagestring任务结果描述
codestring请求结果码,编号20000:成功,其他编号:失败

2.2 返回示例

{    
    "data": {        
        "trace_id": "1571988259683020",        
        "text":"今天是星期四",   
    }, 
    "message":"Success",  
    "code": "20000"   
}

3 通过Postman发送请求示例