语音提问

最近更新时间:2019-08-30 15:33:49

功能描述

用户可以通过语音提问问题,并且可以选择以文本或者语音答复。
支持的格式:amr、wav、silk,建议使用 silk,以及采样率为 16k 的语音。增加的语音文件总大小不得大于 2MB。

请求

请求 URL

https://yun.tim.qq.com/v3/prophet_upload/audio_query_answer?
appid=$appid
&sdkappid=$sdkappid
&identifier=$identifier
&usersig=$usersig
&random=9999
&botid=$botid
&contenttype=file
&comptype=$comptype
&filetype=$filetype
&samplepersec=$samplepersec
&uuid=$uuid

URL 详细字段说明请参阅 URL 字段说明 文档。

字段名称 描述
comptype 语音压缩类型,枚举值: raw,silk, amr
filetype 语音格式,枚举值: raw,wav
samplepersec 语音采样率,枚举值: 16000。暂时不支持 8000。
uuid 上传语音 uuid,需要先调用 getuuid 获取

请参数

该接口请求的请求体为 ptt 文件的二进制信息,建议使用 silk 格式。

响应

响应参数

字段名称 描述 类型
ActionStatus 处理状态 OK:成功;FAIL:失败。 String
ErrorCode 错误码,0:成功;非0:失败。 Int
ErrorInfo 错误信息 String
qid 会话 ID String
audio 语音翻译文本 String
question 问题(编码格式为UTF-8) String
match_str 命中关键词列表(编码格式为UTF-8) String
answer 答案(编码格式为UTF-8) String
qaid 知识库唯一 ID String

示例

请求示例

https://yun.tim.qq.com/v3/prophet_upload/audio_query_answer?
appid=$appid
&sdkappid=$sdkappid
&identifier=$identifier
&usersig=$usersig
&random=9999
&botid=$botid
&contenttype=file
&comptype=$comptype
&filetype=$filetype
&samplepersec=$samplepersec
&uuid=$uuid

(Multipart/form-data)

响应示例

情况1:

如果指定文本回复,那么 HTTP header 中 content-type 为: application/json。

{
    "ActionStatus": "ok",
    "ErrorCode": 0,
    "ErrorInfo": "",
    "qid": "12334441",
    "audio": "问题",
    "answer_list":
    [
        {
            "question": "问题",
            "answer": "answer1",
            "qaid": "Qeewe32"
        },
        {
            "question": "问题",
            "answer": "answer2",
            "qaid": "Qeewe33"
        }
    ]
}

情况2 :

指定语音答复且处理成功,http header 中 content-type 为:audio/silk 语音文件。